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Turbo C++ is highly 
compatible with existing 
Turbo C code. 


Turbo C++ is for C++ and C programmers who want a fast, effi- 
cient compiler; for Turbo Pascal programmers who want to learn 
C++ or C with all the “Turbo” advantages; and for anyone just 
learning C++ or C. Turbo C++ is also for anyone who wants both 
AT&T's C++ version 2.0 and ANSI C. 


C++ is an object-oriented programming (OOP) language. It’s the 
next step in the natural evolution of C. It is portable, so you can 
easily transfer application programs written in C++ from one 
system to another. You can use C++ for almost any programming 
task, anywhere. 


What's in Turbo C++ 


Chapter ! tells you how to 
install Turbo C++. Chapter 2 
tells you fo where you can 
find out more about each of 
these features. 


Introduction 


Turbo C++ includes many of the latest features users ask for: 


a C++: Turbo C++ offers you the full power of C++ programming 
(implementing C++ version 2.0 from AT&T). To help you get 
started, we’re also including C++ class libraries. To help you 
make the transition from C++ version 1.2, we’ve included 
support for version 1.2 streams. 


mw ANSI C: Turbo C++ provides you with an up-to-date imple- 
mentation of the latest ANSI C standard. 


w Borland’s new Programmer's Platform. The Programmer's 
Platform is a new generation user interface; it goes beyond the 
old integrated environment to provide access to the full range 
of programs and tools on your computer. It includes: 

e mouse support 
e multiple overlapping windows 
e a multi-file editor 


¢ support for inline assembler code 


and much more. 


=» VROOMM (Virtual Run-time Object-Oriented Memory 
Manager): VROOMM lets you overlay your code without 
complexity. You select the code segments for overlaying; 
VROOMM takes care of the rest, doing the work needed to fit 
your code into 640K. 


m An online tour of the new programmer's platform. 


w Online hypertext help, with copy-and-paste program examples 
for practically every function. 


m Many indispensable library functions, including heap checking 
functions and a complete set of complex and BCD math 
functions. 


Other features include: 

w An enhancement to the -S option: Now your C source code is 
added as comments to the resultant assembler code. 

w Far objects and huge arrays. 


m Several new pragmas and warnings: an ill-formed pragma 
warning, an argsused pragma, and a start-up pragma. 


m Alternate .CFG files. You can create several and use the one that 
suits your needs at any given time. 


m Response files for the command-line compiler. 


Hardware and software requirements 


Turbo C++ runs on the IBM PC family of computers, including 
the XT, AT, and PS/2, along with all true IBM compatibles. Turbo 
C++ requires DOS 2.0 or higher and at least 640K; it runs on any 
80-column monitor. The minimum requirement is a hard disk 
drive and one floppy drive. 


Turbo C++ includes floating-point routines that let your programs 
make use of an 80x87 math coprocessor chip. It emulates the chip 
if it is not available. Though it is not required to run Turbo C+4, 
the 80x87 chip can significantly enhance your programs’ 
performance. 


Turbo C++ also supports a mouse. Though the mouse isn’t re- 
quired, if you have one, you must have one of the following for 
full compatibility: 
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m Microsoft Mouse version 6.1 or later, or any mouse compatible 
with this mouse 


m Logitech Mouse version 3.4 or later 
m Mouse Systems’ PC Mouse version 6.22 or later 
a IMSI mouse version 6.11 or later 


The Turbo C++ implementation 


Turbo C++ is a full implementation of the AT&T C++ version 2.0. 
It is also American National Standards Institute (ANSD C stan- 
dard and fully supports the Kernighan and Ritchie definition. In 
addition, Turbo C++ includes certain extensions for mixed- 
language and mixed-model programming that let you exploit 
your PC’s capabilities. See Chapter 1, “The Turbo C++ language 
standard,” in the Programmer's Guide for a complete description of 
Turbo C++. 


The Turbo C++ package 


Getting Started and the 
Users Guide tell you how to 
use this product; the Pro- 
grammers Guide and the 
Library Reference focus on 
programming in C. 


Gefting Started 


Introduction 


Your Turbo C++ package consists of a set of distribution disks 
and four manuals: 


a Turbo C++ Getting Started (this manual) 
a Turbo C++ User's Guide 

a Turbo C++ Programmer's Guide 

w Turbo C++ Library Reference 


In addition to the four manuals, you'll find a convenient Quick 
Reference booklet. The distribution disks contain all the programs, 
files, and libraries you need to create, compile, link, and run your 
Turbo C++ programs; they also contain sample programs, several 
standalone utilities, a context-sensitive help file, an integrated 
debugger, and additional C documentation not covered in these 


guides. 


This volume introduces you to Turbo C++ and shows you how to 
create and run both C and C++ programs. It consists of informa- 
tion you'll need to get up and running quickly: installation, tutori- 


You might also want fo try 
the online tutorial, TCTOUR. 


Chapters 5 and 6 work 
together: one is theory, the 
other is practice. 


Tne User's Guide 


als, primers, and a guide to the Turbo C++ documentation set. 
These are the chapters in this manual: 


Chapter 1: Installing Turbo C++ tells you how to install Turbo 
C++ on your system. 


Chapter 2: Navigating the Turbo C++ manuals introduces some of 
Turbo C++ most interesting features; where appropriate, it tells 
you where to find out more about them. 


Chapter 3: Learning the new IDE walks you through the inte- 
grated environment and introduces the new editor, mouse sup- 
port, and other new or changed features. This is a light overview 
of the Turbo C++ system. In-depth information can be found in 
Chapter 1, “The IDE reference,” in the User's Guide. 


Chapter 4: An introduction to C is an overview of the C language. 
This chapter introduces you to the elements of C programs, data 
and data types, operators, functions, arrays, structures, and other 
aspects of the C language. 


Chapter 5: A C++ primer is an introduction to the concepts of 
object-oriented programming using C++. 


Chapter 6: Hands-on C++ is a swift hands-on introduction to C++. 


Chapter 7: Debugging in the new IDE introduces you to the Turbo 
C++ integrated debugger and walks you through sample pro- 
grams with built-in bugs to demonstrate various features of the 
debugger. 


The Bibliography contains a listing of books relating to generic C 
and C++, and to Turbo C++ specifically. 


The User’s Guide provides reference chapters on the features of 
Turbo C++: Borland’s new integrated environment, including the 
greatly enhanced editor and Project Manager, as well as details on 
using Turbo C++’s utilities, command-line compiler, and customi- 
zation program. | 


Chapter 1: The IDE reference provides a complete reference to the 
integrated development environment. 


Chapter 2: Managing multi-file projects tells how to use the 
Project Manager to manage multi-file programming projects. 
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The Programmer's 


Introduction 


Guide 


Chapter 3: The editor from A to Z provides a complete reference 
to the editor. 


Chapter 4: The command-line compiler tells how to use the 
command-line compiler. It also explains configuration files. 


Chapter 5: Utilities describes some of the utility programs that 
come with Turbo C++. 


Chapter 6: Customizing Turbo C++ tells how to use the TCINST 
program to customize Turbo C++. You can adjust onscreen colors, 
editor defaults, compiler and linker defaults, and many other 
aspects of Turbo C++ with this program. 


Appendix A: Turbo Editor macros describes the Turbo Editor 
Macro Language, a powerful utility you can use to enhance or 
change the Turbo C++ editor. 


The Programmer's Guide provides useful material for the experi- 
enced C user: a complete language reference for C and C++, a 
cross-reference to the run-time library, C++ streams, memory 
models, mixed-model programming, video functions, floating- 
point issues, and overlays, plus error messages. 


Chapter 1: The Turbo C++ language standard describes the Turbo 
C++ language. Any extensions to the ANSI C standard are noted 
here. This chapter is basically a language reference and syntax for 
both the C and C++ aspects of Turbo C++. 


Chapter 2: Run-time library cross-reference provides some infor- 
mation on the source code for the run-time library, lists and de- 
scribes the header files, and provides a cross-reference to the run- 
time library, organized by subject. For example, if you want to 
find out which functions relate to graphics, you would look in this 
chapter under the topic “Graphics.” 


Chapter 3: C++ streams tells you how to use the C++ version 2.0 
stream library. The earlier version stream library is documented 
online. 


Chapter 4: Memory models, floating point, and overlays covers 
memory models, mixed-model programming, floating-point con- 
cerns, and overlays. 


Chapter 5: Video functions is devoted to handling text and 
graphics in Turbo C++. 


Chapter 6: Interfacing with assembly language tells how to write 
assembly language programs so they work well when called from 
Turbo C++ programs. 


Chapter 7: Error messages lists and explains all run-time and 
compiler-generated errors and warnings, and suggests possible 
solutions. 


Appendix A: ANSI implementation-specific standards describes 
those aspects of the ANSI C standard that have been left loosely 
defined or undefined by ANSI. These aspects will vary, then, 
according to each implementation. This appendix tells how Turbo 
C++ operates in respect to each of these aspects. 


The Library 


Reference The Library Reference contains a detailed list and explanation of 
Turbo C++’s extensive library functions and global variables. 


Chapter 1: The run-time library is an alphabetically arranged 
reference to all Turbo C++ library functions. Each entry gives 
syntax, include files, an operative description, return values, and 
portability information for the function, and a reference list of 
related functions. | | 


Chapter 2: Global variables defines and discusses Turbo C++’s 
global variables. You can use these to save yourself a great deal of 
programming time on commonly needed variables (such as dates, 
time, error messages, stack size, and so on). 


Typefaces used in these books 


All typefaces used in this manual were produced by Borland’s 
Sprint: The Professional Word Processor, on a PostScript laser 
printer. Their uses are as follows: 


Monospace type This typeface represents text as it appears on- 
screen or in a program. It is also used for any- 
thing you must type (such as TC to start up 
Turbo C++). 


ALL CAPS We use all capital letters for the names of 
constants and files. 


[] Square brackets in text or DOS command lines 
enclose optional items that depend on your 
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How to contact Borland 


Introduction 


Boldface 


Italics 


Keycaps 


<< 


rs 


system. Text of this sort should not be typed 
verbatim. 


Angle brackets in the function reference section 
enclose the names of include files. 


Turbo C++ function names (such as printf) and 
structure names are shown in boldface when 
they appear in text (but not in program ex- 
amples). This typeface is also used in text, but 
not in program examples, for Turbo C++ 
reserved words (such as char, switch, near, and 
cdecl), for format specifiers and escape 
sequences (%d, \t), and for command-line 
options (/A). 


Italics indicate variable names (identifiers) that 
appear in text. They can represent terms that 
you can use as is, or that you can think up new 
names for (your choice, usually). They are also 
used to emphasize certain words, such as new 
terms. 


This typeface indicates a key on your keyboard. 
It is often used to describe a particular key you 
should press. (For example, “Press Esc to exit a 
menu.”) 


This icon indicates keyboard actions. 


This icon indicates mouse actions. 


The best way to contact Borland is to log on to Borland’s Forum 
on CompuServe: Type GO BOR from the main CompuServe menu 
and choose “Borland Programming Forum B (Turbo Prolog & 
Turbo C)” from the Borland main menu. Leave your questions or 
comments there for the support staff to process. 


If you prefer, write a letter with your comments and send it to 


Borland International 
Technical Support Department—Turbo C++ 


1800 Green Hills Road 
P.O. Box 660001 
Scotts Valley, CA 95066-0001, USA 


See the README file included You can also telephone our Technical Support department be- 
a ect paihcaliel sae tween 6 am and 5 pm Pacific time at (408) 438-5300. Please have 
bug. the following information handy before you call: 


1. Product name and serial number on your original distribution 
disk. Please have your serial number ready, or we won't be 
able to process your call. 

2. Product version number. The version number for Turbo C++ is 
displayed when you first load the program and before you 
press any keys. 

3. Computer brand, model, and the brands and model numbers 
of any additional hardware. 

4, Operating system and version number. (The version number 
can be determined by typing VER at the MS-DOS prompt.) 

5. Contents of your AUTOEXEC.BAT file. 


6. Contents of your CONFIG.SYS file. 
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Installing Turbo C++ 


Your Turbo C++ package includes two different versions of the 
Turbo C++ compiler: the integrated environment version and a 
command-line version. You must use the INSTALL program to 
install Turbo C++ on your system; it automatically copies files 
from the distribution disks to your hard disk. There is no copy 
protection. For reference, the README file on the installation 
disk includes a list of the distribution files. 


ifyou don't already know We assume you are already familiar with DOS commands. For 
how fo use DOS commands, example, you'll need the DISKCOPY command to make backup 
refer to your DOS reference : wane : : ; 
manual before setting uo COPies of your distribution disks. Make a complete working copy 
Turbo C++ on your system. of the distribution disks when you receive them, then store the 


original disks away in a safe place. 


If you are not familiar with Borland’s No-Nonsense License State- 
ment, read the agreement included with your Turbo C++ 
package. Be sure to mail us your filled-in product registration 
card; this guarantees that you'll be among the first to hear about 
the hottest new upgrades and versions of Turbo C++. 


This chapter contains the following information: 


g installing Turbo C++ on your system 

m accessing the README file 

m accessing the HELPME! file 

ma pointer to more information on Turbo Calc 


Once you have installed Turbo C++, you'll be ready to start 
digging into Turbo C++. But certain chapters and manuals were 
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written with particular programming needs in mind. Chapter 2, 
“Navigating the Turbo C++ manuals,” tells where to find out 
more about Turbo C++’s features in the manuals. 


Installing Turbo C++ 


Important! 


To exit Turbo C++, press Alt-X. 
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Turbo C++ has an automatic installation program called 
INSTALL. You must use INSTALL. This program detects what 
hardware you are using and configures Turbo C++ appropriately. 
It also creates directories as needed and transfers files from your 
distribution disks (the disks you bought) to your hard disk. Its 
actions are self-explanatory; the following text tells you all you 
need to know. 


To install Turbo C++: 


1. Insert the installation disk into drive A. Type the following 
command, then press Enter. 


2: A: INSTALL 
3. Press Enter at the installation screen. 
4. Follow the prompts. 


When it is finished, the INSTALL program reminds you to read 
the latest about Turbo C++ in the README file, which contains 
important, last-minute information about Turbo C++. The 
HELPME!.DOC file also answers many common technical 
support questions. 


Also, once you have installed Turbo C++, you'll get a chance to 
try out TCTOUR. TCTOUR is a guided tour of some of the 
highlights of the new Turbo C++ integrated environment. 
TCTOUR is in the TOUR subdirectory (off of your Turbo C++ 
directory). 


Once you have installed Turbo C++ and tried out TCTOUR, and if 
you’re anxious to get up and running, change to the Turbo C++ 
directory and type Tc. Press Enter. Otherwise, continue reading 
this chapter and the next for important start-up information. 


After you have tried out the Turbo C++ integrated environment, 
you may want to permanently customize some of the options. The 
TCINST program makes this easy to do. See Chapter 6, “Custom- 
izing Turbo C++,” in the User's Guide for instructions. 
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Laptop systems 


The README file 


See Chapter 3, “Learning the 
new IDE,” in this volume, and 
Chapter I, “The IDE refer- 
ence’ in the Users Guide, for 
more details on using the 
new integrated environment. 


If you have a laptop computer (one with an LCD or plasma 
display), in addition to carrying out the procedures given in the 
previous sections, you need to set your screen parameters before 
using Turbo C++. The Turbo C++ integrated development envi- 
ronment version (TC.EXE) works best if you type MODE BW80 at the 
DOS command line before running Turbo C++. 


Although you could create a batch file to take care of this for you, 
you can also easily install Turbo C++ for a black-and-white screen 
with the Turbo C++ customization program, TCINST. See Chap- 
ter 6, “Customizing Turbo C++,” in the User's Guide for instruc- 
tions. With this customization program, choose “Black and 
White” from the Screen Modes menu. 


The README file contains last-minute information that may not 
be in the manuals. It also lists every file on the distribution disks, 
with a brief description of what each one contains. 


To access the README file: 


1. If you haven’t installed Turbo C++, insert your Turbo C++ 
disk into drive A. If you have installed Turbo C+4, skip to step 
3 or go on to the next paragraph. 


2. Type A: and press Enter. 


3. Type README and press Enter. Once you are in README, use the 
T and J keys to scroll through the file. 


4. Press Esc to exit. 


If you've already installed Turbo C++, you can open README 
into an edit window, following these steps: 


1. Start Turbo C++ by typing TC on the command line. Press Enter. 


2. Press F10. Choose File | Open. Type in README and press Enter. 
Turbo C++ opens the README file in an edit window. 


3. When you’re done with the README file, choose File | Quit 
(or continue playing with the new environment). 
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The HELPME!.DOC file 


Your installation disk contains a file called HELPME!.DOC, which 
contains answers to problems that users commonly run into. 
Consult it if you find yourself having difficulties. You can use the 
README program to look at HELPME!.DOC. Type this at the 
command line: 


README HELPME! .DOC 


Turbo Calc 


Your Turbo C++ package includes the source code for a 
spreadsheet program called Turbo Calc. Before you compile it, 
read the online documentation (TCALC.DOC) for it. 
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Navigating the Turbo C++ manuals 


Features 


This chapter accomplishes two things: 


mw It tells you briefly about Turbo C++’s hottest features: what they are, 
the concepts behind them, how to use them. 


mw It tells you where in these manuals you can find out more about the 
new features and other aspects of Turbo C++. 


If you read the instructions on how to install Turbo C++ on page 10, 
you also learned how to start Turbo C++ and how to exit from it. If not, 
and if you want to just jump right in and start programming, refer back 
to that page. 


C++ 


Turbo C++ has many powerful features, listed on page 1. This section 
tells you a little more about some of these features, and points you to 
where you can go for in-depth information on them. 


With Turbo C++, you get two compilers in one. You get all the capabili- 
ties of ANSI C, plus all the capabilities of C++. Chapters 5 and 6, “A 
C++ primer” and “Hands-on C++,” provide the theory of C++ pro- 
gramming and a tutorial. 


In addition to this, we’ve included a ready-made set of C++ class librar- 
ies for you to use. These libraries use classes to perform a variety of 
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VROOMM 
Coverlays) 


Chapter 4, “Memory models, 


floating point, and overlays, 


a 


in the Programmers Guide 
covers overlays in depth. 


Borland’s new 
integrated 
environment 


functions for you. So some advantages of C++, such as extensibility and 
reusability, are yours immediately. 


Turbo C++’s VROOMM (Virtual Run-time Object-Oriented Memory 
Manager) gives you intelligent overlays, unlike any overlay scheme 
you may have used before. If you are already familiar with overlays in 
another (non-Borland) product, you have some pleasant surprises 
coming. First, VROOMM can determine how and when to overlay, thus 
relieving you of that task. Second, since VROOMM is based on a set of 
highly sophisticated algorithms, it is much faster and more efficient 
than other overlay schemes. 


Because Borland’s integrated environment has been completely redone, 
we recommend that you take the guided tour provided by TCTOUR 
even if you are already familiar with other Borland products. First 
change directories to the TOUR subdirectory (in your TC directory). 
Then type TCTOUR and press Enter. 


For more, read Chapter 3, “Learning the new IDE.” This chapter gives 
hands-on experience with a range of features in the new integrated 
environment, including mouse support, the help system, the clipboard, 
new ways to handle windows, editing multiple files, transferring out to 
other programs (and then back into Turbo C++), and so on. Chapter 1, 
“The IDE reference,” in the User’s Guide is a reference to every aspect of 
the new integrated environment. 


Using the manuals 
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The manuals are arranged so that you can pick and choose among the 

books and chapters to find exactly what you need to know at the time 

you need to know it. Getting Started and the User’s Guide provide infor- 
mation on how to use Turbo C++ as a product; the Programmer's Guide 
and the Library Reference provide material on programming issues in C 
and C++. 


Five chapters in this volume provide introductions to and tutorials on 
subjects of interest: 


w Chapter 3, “Learning the new IDE” 
m Chapter 4, “An introduction to C” 
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m Chapter 5, “A C++ primer” 
m Chapter 6, “Hands-on C++” 
a Chapter 7, “Debugging in the new IDE” 


As mentioned earlier, the integrated environment is brand new, so you 
might want to browse through the first chapter on this list even if you 
are familiar with Turbo C or Turbo Pascal. 


The chapters of the User’s Guide are for use as reference chapters to 
using Turbo C++: 


Refer se dae sete as =m Chapter 1, “The IDE reference” 
needed after you have “ ; _¢s «ntol 
worked inrodahihe. Chapter 2, “Managing multi-file projects 
appropriate introductions ™ Chapter 3, “The editor from A to Z 
and tutorials. Chapter 4, “The command-line compiler” 
m Chapter 5, “Utilities” 
m Chapter 6, “Customizing Turbo C++” 
m Appendix A, “Turbo Editor macros” 


New 


programmers Or If you are learning C, start with chapters 3 and 4, “Learning the new 
programmers IDE” and “An introduction to C,” in this book. These chapters intro- 
duce you to the Turbo C++ integrated environment and give you an 
learning C overview of programming in C. Chapters 5 and 6, “A C++ primer” and 
“Hands-on C++,” give a brief introduction to programming in C++. 
The bibliography lists useful Depending on how much you want to be on the leading edge of tech- 
sources for further nology and on how confident you feel about programming in C, you 
information on ©. may want to jump right into those chapters after reading Chapter 4. 
Chapter 7, “Debugging in the new IDE,” runs you through the Turbo 
C++ integrated debugger. Later, you can use chapters 1 through 6 in the 
User's Guide for reference. 


Your next step is to start programming in C. For the most part, you will 
be using the Library Reference. Or, you might prefer to use the online 
help; it contains much of the same information as the Library Reference, 
and includes programming examples for almost every function that 
you can copy into your own program. 


Experienced C 
programmers _ If you are an experienced C programmer and you've already installed 
Turbo C++, you'll probably want to jump immediately to the Program- 
mer’s Guide and to the Library Reference. If, however, you want to learn 
more about the new Turbo C++ integrated environment, including the 
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integrated debugger, read chapters 3 and 7 (“Learning the new IDE” 
and “Debugging in the new IDE”) in this book. 


If you are interested in C++, read chapters 5 and 6, “A C++ primer’and 
“Hands-on C++. 


The Programmer's Guide covers certain useful programming issues, such 
as C++ streams, assembly language interface, memory models, video 
functions, overlays, and far and huge pointers. In addition, the Program- 
mer’s Guide provides a cross-reference to the Library Reference by 
functionality (Chapter 2, “Run-time library cross-reference”). So, for 
example, if you want to know which C functions are associated with 
graphics, you would turn to that chapter and look up the subject 
“Graphics.” 
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Note: Before you run this 
tutorial, you must install Turbo 
C++ with the default 
subdirectories. See Chapter | 
for details. 


Learning the new IDE 


In this chapter, you'll get hands-on experience with Turbo C++’s 
new version of the Borland integrated development environment 
(IDE). Even if you’re already familiar with other Borland pro- 
ducts, we recommend that you work through this chapter. Turbo 
C++ introduces the new IDE; this chapter gives you an overview 
of some of the most important new features. This tutorial consists 
of three lessons: 


m Lesson 1 shows how to start Turbo C++ and how to load, edit, 
and save files. 


m Lesson 2 covers how to compile and run a program from 
within the IDE. 


= Lesson 3 exits you from Turbo C++. 


If your fingers are itchy and you want to get up and running on 
Turbo C++ right now, go to Chapter 1 on page 10. Otherwise, read 
through this tutorial to learn the basics of using the IDE. It should 
take you about 30 minutes to finish. 


If you want in-depth information about specific items on the 
menus or in the dialog boxes, refer to Chapter 1, “The IDE refer- 
ence,” in the User's Guide. If you’d like to step through an online, 
interactive tour of the IDE, ran TCTOUR.EXE (type tctour at the 
DOS prompt while in the TOUR subdirectory of your TC 
directory). 


Chapter 7, “Debugging in the new IDE,” gives you a long tutorial 
on debugging. 
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Figure 3.1 
Components of the IDE 


The Turbo C++ IDE contains windows, menus (pull-down and. 
pop-up), dialog boxes, and a status line. Here’s a diagram of a 
typical IDE screen’s components: 


Menu item 


Check box off 
Check box on 


Check box on 


Check box off 


Radio button off 
Radio button on 


Radio button off 


Status line 


To get into the IDE menu system, press F10, then press the high- 
lighted letter of any item on the menu bar. (You can also press Alt 
and the highlighted letter; for example, Alf-F opens the File menu, 
and so does F10 F.) 


To get out of the menus, press Esc until all menus are closed and 
you’re back at one of the windows. 


The Turbo C++ IDE uses dialog boxes to display options. A dialog 
box contains one or more of the items listed in the following table. 
(If you're itching to try Turbo C++ right now, read the first few 
paragraphs on page 10.) 
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Table 3.1 
What goes in a dialog box tem What it looks like, what it does 


Action Button Action buttons are "shadowed" text. If you choose a 
button (press Enter or click), Turbo C++ carries out the 
related action immediately. 


Check box A check box is an On/Off toggle. Press Spacebar or click it 
to turn the option on or off. When a check box option is 
turned on, an x appears in the brackets: [x]. 


Radio button Radio buttons are toggles that come in sets of two or 
more: You can only choose one radio button in a set at a 
time. With the keyboard, you can move within a set of 
buttons using the arrow keys. Once you’ve made your 
selection, press Jab to leave that group with the new 
button chosen. With the mouse, you can click anywhere 
on a radio button to choose it. When a radio button is 
chosen, a bullet appears between the parentheses: (¢). 


Input box An input box prompts you to type in a string (the name 
of a file, for example). 


List box A list box contains a list of items from which you can 
choose (for example, a list of possible files to open). 


Dialog boxes appear when you choose a menu item that is follow- 
ed by a dialog box icon (...), such as the File | Open menu item 
shown in Figure 3.3. 


Full Menus On/Off 


Turbo C++ lets you choose between two menu systems, Full 
Menus On and Full Menus Off. Full Menus Off provides you with 
a condensed, easy-to-use environment by offering you the mini- 
mal command set you'll need to build and debug Turbo C++ 
programs. Full Menus On provides you with the extra functional- 
ity you'll need for more advanced programming tasks. In this 
tutorial, we use Full Menus set to Off (the default setting). 


Figure 3.2 compares the two menu states; as an example, it shows 
the Compile menu with Full Menus Off and Full Menus On. 


Chapter 3, Learning the new IDE 19 


Figure 3.2 | 
Full Menus: Off and On Full Menus Off Full Menus On | 


Make EXE file | Compile to OBJ 
Build All Make EXE File 
, | Link EXE File 


Build All 


Remove messages 


Mouse, hot keys, 


and online help Before you jump feet first into the IDE, you’ll want to know the 
basics of Turbo C++’s mouse support, hot keys, and online help. 


Mouse The Turbo C++ IDE supports a mouse. Use the left mouse button 
ie — ope! icra eet for the IDE. Turbo C++ also lets you redefine your other mouse 
mouse before, Duttons: Refer to Chapter 1, "The IDE reference," in the User’s 


Guide for details. These terms describe mouse actions: 
Table 3.2 : 


Mouse talk Action How you do it 
~~" Click Press the mouse button and release. 

Double click Click twice in quick succession. 

Drag Press the mouse button, move the mouse, release. 

Click-drag Press the mouse button and release, then press it again, 
move, and release. 

Choose Click a menu item, such as a command or dialog-box 
selector. 


Hot keys Many menu and dialog box items have corresponding hot keys: 
one- or two-key shortcuts that immediately activate that com- 
mand or dialog box. (In a dialog box, unless you’re in an input 
box, you only need to press the highlighted letter to move from 
one command to another.) The following table lists the most-used 
Turbo C++ hot keys; see Chapter 1, "The IDE reference," in the 
User’s Guide for a more complete list. 
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Table 3.3 


FY Help Opens an online help screen. 
bey ape aa sd aie F2 File | Save saves the file that’s in the active Edit 
that key’s function window. 
everywhere, except in dialog F3 File | Open Brings up a dialog box so you can open 
Db . 
Cage a file. 
F4 Run!Goto Cursor Runs your program to the line where 
the cursor is positioned. 
FS Window | Zoom Zooms and unzooms the active 
window. 
F6 Window | Next Cycles through all open windows. 
F7 Run | Trace Into Runs your program in debug mode, 


tracing into functions. 


F8 Run | Step Over Runs your program in debug mode, 
stepping over function calls. 


F9 Compile !Make Exe Makes the current source file an EXE 
file. 


F10 (none) Takes you to the menu bar. 


@e = The status line at the bottom of the IDE screen lists hot keys you 
can use in the active window. If you have a mouse, you can click 
the hot key in the status line instead of pressing the key. 


Online help Turbo C+4, like other Borland products, gives you context-sensi- 
tive online help at the touch of a hot key (or the click of a button). 
You can get help regarding any item in the Turbo C++ IDE, plus 
help about any Turbo C++ reserved word or library function. In 
addition, you can copy example programs from the Help window 
into your Own programs. 


You'll use the help system in Turbo C++ also provides a "mini help system" that is always 
Lesson2. available at a glance. The status line at the bottom of the IDE 
screen lists any hot keys or commands available in the current 
window, menu, or dialog box, and provides a brief description of 
what the current menu or dialog control item does. 


Lesson |: Starting, loading, and editing 


This lesson should take you 20 Turbo C++’s IDE comes with its own built-in editor. From within 
minutes to complete. Turbo C++, you can open a file, edit, compile, run, debug, and 
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Figure 3.1 
The Load a File dialog box 


lf you have a mouse, just 


double-click the file name in 
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the Files list. 


save it to disk again—all with the IDE’s easy-to-use features. In 
this lesson, you'll 

m start Turbo C++ at the DOS prompt 

m open a file in an Edit window 

m copy the file to another Edit window 

m use the editor to modify the copied file 

m save the modified file to disk 

To start Turbo C++, change to the EXAMPLES subdirectory (in 
your TC directory) and type ..\TC at the DOS prompt. To load the 
Turbo C++ program BARCHART.C into the IDE, choose the File | 


Open command or press F3. Either of these methods displays the 
Load a File dialog box, which looks like this: 


po ——————— load File = SSS 


Rep lace | 
INTRO13.C | 
INTRO14.C . 
INTRO15.C 
INTRO16.C 


INTRO17.C 
INTRO18 
INTRO19 
sie a Help | 


> \TC\EXAMPLES\*.C 
BARCHART .C 1506 Feb 20,1990 3:00am 


Note that the Open button is the default in this dialog box. If you 
choose Replace instead of Open, your file will replace any file 
currently in the active Edit window, instead of placing it ina new 
window. Leave the Open button selected for this lesson. 


From this dialog box, there are two ways to select a file to open: 
m You can enter the file name in the Name input box. 

m Or, you can choose the file from the Files list. 

This time you'll use the Files list. 


. Press Jab to activate the Files list. 


2. Normally, you would use the arrow keys to highlight your 
selected file. In this case, BARCHART.C is already highlighted 
because it’s the first file in the list. 


3. Press Enter. 


pawl 
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Creating a new 
file 


To go directly to any Edit 
window, press Alt and that 
window's number. 


Table 3.1 
Moving in an Edit window 


As soon as you choose the file (press Enter), BARCHART.C is 
displayed in the Edit window. Note the window number in the 
upper right border of the Edit window; this is window 1. The line 
and column number information for the Edit window is in its 
lower left corner. 


One feature of the Turbo C++ IDE is multiwindowing—you can 
have more than one Edit window open at a time. You can open a 
different or the same file in each window, cut or copy and paste 
between windows, and move easily from window to window. 


Now that BARCHART.C is open in an Edit window, you’re ready 
to start editing the code. But, because you don’t want to alter the 
original program, open a new Edit window with File | New. 


The new Edit window is NONAMEO00.C (window 2), which you'll 
later name MYCHART.C. The double line around the new Edit 
window tells you that it’s the active window. 


Now go back to the first Edit window (click it or press Alt-1). We 
want you to copy all of BARCHART.C into NONAMEO0.C. (If 
you're not familiar with moving around in an Edit window, take a 
look at the following table or press F1 while you’re in the editor. 
For a full listing of the editor commands, refer to Chapter 3, “The 
editor from A to Z,” in the Lser’s Guide.) 


To move On the keyboard With the mouse 
A character or line Press T, J, Click the arrow at 
in any direction —, Or — either end of scroll bar 


To beginning or Press Home or End Click at beginning 

end ofa line or end of line 

Up or down a screen Press PgUpor PgDn = Click and hold the 
arrow at either end of 
the scroll bar to scroll 

To beginning or end Press Ctri-PgUp or Click-drag the thumb 

of file Ctrl-PgDn tab (square icon) at 


either end of the scroll 
bar; move to top or 
bottom of bar; release 
mouse button 
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selecting a block 


Restore line  Alt-Bksp 
Cut Shift-Del 
Copy Ctrl-Ins 


Paste Shift-Ins 


Copy Example 


Clear Ctrl -Del 


Copying and pasting 


Modifying your 
new file 
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When marking blocks, you can choose between the keyboard and 
the mouse: 


m From the keyboard, place the cursor at the first or last character 
of the block, then press Shiftand an arrow key (or Home, End, 
PgDn, or PgUp) to select the block. (You must press Shift while 
you're using the arrow keys.) 


m With the mouse, click the first character of the block, then drag 
to the end of the block. To unselect a block, click anywhere. 


A selected block of text displays in reverse video (highlighted). 
Go ahead and select all the code in BARCHART.C. 


Now that you’ve selected the text in the BARCHART.C window, 
choose Edit | Copy (or press Cirl-ins). This copies the selected text to 
a special holding place in memory called the Clipboard. Once text 
is in the Clipboard, you can paste it into a new location—in the 
same window or a different one. 


Move back to NONAMEO0.C: Press Alf and that window’s number 
(or click that Edit window with the mouse). (If you want to move 
to a particular window but don’t know its number, use Window | 
List.) 


To paste text from the Clipboard into the Edit window, choose 
Edit | Paste (or press Shift-ins). Next, unselect the pasted block; click 
anywhere or press Ctrl-K H. 


Now you're ready to make some changes to the text, and save and 
name the NONAME00.C file. 


BARCHART.C is a program that prompts for ten scores between 0 
and 50, computes their percentages, then displays the percentages 
in a bar chart and prints out the scores and percentages. 


In this section, you’re going to make some improvements to 
BARCHART.C: 


a change your version of BARCHART.C (NONAMEO00.C) so that 
it prompts for five scores between 0 and 35 


m use the editor's search-and-replace feature to change a variable 
name 


m copy and paste text from a Help window 
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Look for the line number at 
the bottom of the Edit 
window. 


searching and 
replacing 


Figure 3.2 
The Replace dialog 


Let’s start off by editing the file to prompt for a different number 
of scores within a different range. Here’s what you do: 


1. Use the cursor keys to move to the end of line 7. 
2. Use Backspace to remove the number 50, and type in 35. 
3. Move to the next line and change the number 10 to 5. 


The variable name 7 isn’t a very informative identifier, so go ahead 
and change it to index, since that’s what the variable is used for. 
Changing a single-letter variable is a little trickier than it might 
first appear. You want to change every instance of the variable 1; if 
you miss one, the program won’t compile because you'll have an 
undefined variable. But you don’t want to change every letter i in 
the program, just each instance of the variable i. 


Fortunately, the Search menu includes an option for selective 
search-and-replace operaiions. You'll be using the Replace dialog, 
which looks like this: 


piiext_ to Findg 
Pew Text 


U Pd ce Direction 
rd Case sensitive (e)} Forward 
| ; Whole words only ) Backward 


Regular expression 
Prompt on replace 


cope Urigin 


(0) Global (°) From cursor 
Selected text Entire scope 


gt Oe eam chance [NT /immicancel Mmmm. Help 


The Replace dialog box contains two input boxes, three sets of 
radio buttons, a set of check boxes, and four buttons. You’re going 
to change all instances of variable i in NONAMEO0 to index, so go 
to the beginning of the file (press Ctrl-PgUp or use the mouse). 


1. Choose Search | Replace to open the Replace dialog box. When 
you first open the dialog box, the Text to Find input box is 
active. 

2. Type i, the name of the variable you want to search for, then 
press /ab to activate the New Text input box. 

3. Type index, the name you want to substitute for 7. Press Tab 
again to move control to the Options check boxes. 
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To check Whole Words Only, 
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press | to move fo it, then 
press Spacebar. Or, click it. 


Pasting from a Help 
window 


Case Sensitive and Prompt to Replace are already checked. 
That’s exactly what you want. But you also need to check 
Whole Words Only so that the search won’t stop at every letter 
iin the program. After you check that option, leave this group 
as is and press 1/40, or click, to go to the Direction radio 
buttons. 


. You want the search direction to be forward, so just go ahead 


and tab to Scope. 


. Global is already chosen in the Scope set of radio buttons, 


which means the search will be through the entire document. 
Now press /ab to go to Origin. 


. In Origin, press | to move to Entire Scope (or click it) to 


choose it. 


. Tab to the Change All button and press Enter to initiate the 


search-and-replace operation (or click the button with the 
mouse). 


At each instance of ani, you’re prompted whether you want to 
replace that occurrence. Press Y for Yes if the search finds the 
variable i; otherwise press N for No. 


Suppose you want to add this caption to your bar graph: 


Percentages, Exam 1A 


The function that outputs text to the screen in graphics mode is 
outtextxy; the help screens describing this function contain code 
you can copy to the Clipboard and then paste into NONAMEOO. 
Here’s how to copy outtextxy’s example code from the help screen 
to your source: 


I. 
2; 


Choose Index from the Help menu. 


Type the word outtextxy to go to the entry for outtextxy. Then 
press Enter to bring up its help screen. 


. The example is already preselected as a block, so choose Edit | 


Copy Example to copy it into the Clipboard. 


. Press Esc to close the Help window. 
. Go to the end of your file and position the cursor at the 


beginning of the last line. 


. Choose Edit | Paste to paste the block of code into your file. 
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You wont use the whole block as it stands. While parts are useful 
just as they are, others must be modified to suit your purposes, 
and some are no use to you in this example. 


Once you've copied the example into your program, you can 
modify the lines you want to keep, then discard the rest. For 
example, 


1. You can use the line 
int midx, midy; 
as is. Cut this line (from the example text you just added at the 
end of your program), then paste it into the makegraph 
function’s variable declaration section (line 35). 
2. Paste these two copied lines into makegraph just after the 
closing brace of the for loop (line 49). 
midx = getmaxx()/2; 
midy = getmaxy()/2; 
3. Modify them to read 
midx = (getmaxx()/2) - (textwidth("Percentages, Exam 1A") /2); 
midy = getmaxy() - 10; 
4. Paste this copied line into makegraph right after the modified 
midy statement: 
outextxy(midx, midy, "This is a test.") 


5. Modify it to read 


outtextxy(midx, midy, “Percentages, Exam 1A"); 


You need to get rid of the mangled remains of the outtextxy 
sample program at the end of your file. Fortunately, the Edit 
menu provides you with a command for getting rid of blocks of 
text with just a couple of quick keystrokes. 


1. Select the block you want to delete: Start where you typed in 
outtextxy, and stop at the end of the file. 


2. Choose Edit | Clear (or press Cirl-Del). 


saving your changes _ That’s it. You've made quite a few changes to your program, so go 
ahead and save the file to disk. Choose File | Save (or press F2), 
which brings up the Save Editor File dialog box. At the input box, 
type in MYCHART.C and press Enter. 
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Lesson 2: Compiling and running 


This lesson takes 5 minutes. 


Make EXE file C:MYCHART.EXE 


Build A 


Note: if you get error 
messages stating that Turbo 
C++ can't find your header 
files, Turbo C++ probably is 
not installed with the default 
subdirectories. See Chapter ] 
for details. 


Run 


Progran reset Sa | 
F4 


Go to cursor 
Trace into F7 


Step over F8 
Arguments... 


The User Screen displays both 
text and graphics oufpuf. 
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In this lesson, you'll 


m compile MYCHART.C with the Compile | Make EXE command 


a run MYCHART.EXE with the Run! Run command (so you can 
see the output) 


You use the Compile menu to compile the program. (Because the 
Full Menus option is set to Off for this tutorial, this Compile 
menu shows only two items. To find out what all the Compile 
menu options do, see Chapter 1, “The IDE reference,” in the User's 
Guide.) 


1. Choose Compile | Make EXE File or press F9 to generate 
MYCHART.EXE. The Compiling window appears; if there are 
any errors in your program, it’ll tell you here (if so, fix them 
and recompile). When the program successfully compiles and 
links, the window displays a flashing message: 


Success: Press any key 


2. Press any key to return to your program. 


To run MYCHART, choose Run | Run or press Cirl-F9. (The other 
commands on the Run menu are for debugging.) Turbo C++ 
switches from the IDE to the User Screen, where MYCHART 
prompts you for input. 

Each time MYCHART prompts you for input (five times in all), 
enter an integer between 0 and 35. As soon as you enter the last 
number, MYCHART displays all five values and their 
percentages. 


Press Entér. Now MYCHART displays the percentages in the form 
of a bar graph. Notice how nicely the caption is centered under 
the bar graph. If you’re curious about how that happened, check 
out this line: 


midx = (getmaxx()/2) - (textwidth("Percentages, Exam 1A") /2); 


Press Cir-F1 while the cursor is positioned on the function 
textwidth to get language-specific help (or look in Chapter 1, “The 
run-time library,” in the Library Reference). 


Press Enter again to return to the IDE. 
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Closing an Edit 


WINdCOW Now you’re finished with MYCHART.C. To close its Edit win- 


dow, choose Window | Close (or press Alf-F3). Go ahead and close 
BARCHART-C as well. 


@e «s/f you have a mouse, you can click the close box ([®]) in the upper 
left corner to close the Edit window. 


Lesson 3: Exiting Turbo C++ 


When you finish working on a file, the last two things to do are 


™ save your changes toa file on disk 
m exit the Turbo C++ IDE and return to DOS 


You've already saved your file, so the last step is to quit Turbo 
C++ and return to DOS. 


m Choose File | Quit or press Alf-X. 


Where to go for more information 


This tutorial was just a quick introduction to the most commonly 

used parts of the Turbo C++ IDE; many features were touched on 
briefly or not at all. Remember, you can find in-depth information 
on every part of the IDE in Chapter 1, “The IDE reference,” in the 

User's Guide. 
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An introduction fo C 


If you've never programmed in C before (or if you have and 
would just as soon forget the experience), this is the chapter for 
you. It starts out with simple examples and moves to more com- 
plex ones, showing you how to build them into programs. You'll 
learn how to solve a variety of problems involving numbers, 
words, and graphics. You are also introduced to some important 
guidelines for designing and structuring programs. You'll find 
code for the more complex programs in the EXAMPLES sub- 
directory. We've included them this way so you can easily load, 
compile, and run them; this is one of the best ways to learn C. 


A quick history lesson 


C was originally developed in the 1970s for use with the UNIX 
operating system, and virtually grew up with it. When micro- 
computers with sufficient power came on the market, C compilers 
were implemented for them. In 1978, Brian W. Kernighan and 
Dennis M. Ritchie provided the classic definition of C with the 
first edition of their book The C Programming Language. Five years 
later, the American National Standards Institute (ANSI) began to 
develop a new standard for the C language. This. standard 
resolves ambiguities in the classic definition and provides new 
features, including better control over function calls through the 
use of prototypes. The second edition of Kernighan and Ritchie’s 
book discusses the ANSI standard implementation in detail. 
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Turbo C++ implements the latest ANSI standard for C. It is also a 
full implementation of version 2.0 of AT&T’s object-oriented 
version of C called C++. The object-oriented features of C++ are 
discussed in chapters 5 and 6, “A C++ primer” and “Hands-on 
C++.” 


Basic programming operations 


You can follow along with 
the examples in this chaofer 
by loading and running the 
clesignated programs. 


To try out this program, load 
and run INTROI.C (ile | 
Open | INTRO 1). Remember 
that all these examples are in 
the EXAMPLES subdirectory. 
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Computer programs vary greatly in purpose, style, and complexi- 
ty. Nearly all programs, however, go through a process consisting 
of three phases: 


m describing, collecting, and storing information (data) 
m processing the data to achieve the desired result 
m displaying and/or storing the results 


Any data used by a program has to be described so that Turbo 
C++ knows how to store and retrieve it. Memory must be set 
aside to hold the amount of data expected. The program must 
then use some means to get the actual data into storage—this 
could involve reading the characters from the keyboard, 
retrieving data from a file on disk, receiving data over a telephone 
line, or using some other kind of input device. 


Once the data has been stored in numeric variables, character 
strings, arrays, or more complicated data structures, it must be 
processed. The processing varies with the purpose of the pro- 
gram, of course: A spreadsheet program might apply a formula to 
a set of data to calculate a result, while a word-processing 
program might rearrange lines of text to fit new margins. 


Once the data is processed, the results must be made available in 
some way to the user. Lines of text can be rearranged on the 
screen or sent to the printer, and the spreadsheet cells can be re- 
displayed to show their new values. Most data must eventually be 
stored on disk for later use. 


Consider how the foregoing elements of program design are used 
in this short example program: | 


/* INTRO1.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main () 
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int bushels; 

float dollars, rate; 

char inbuf [130]; 

printf("How many dollars did you get? "); 
gets (inbuf); 

sscanf(inbuf, "Sf", &dollars); 
printf("For how many bushels? "); 

gets (inbuf) ; 

sscanf(inbuf, "Sd", &bushels); 

rate = dollars / bushels; 

printf("You got %f dollars for each bushel\n", rate); 


return 0; 


The first line of this program, main(), defines a function, or group 
of related program instructions. Functions are the building blocks 
of C programs, much as paragraphs are the building blocks of 
stories. Every C program has a function called main. Most pro- 
grams have several other functions with appropriate descriptive 
names. The open brace ({) indicates the beginning of a group of 
program instructions, or statements—in this case, the statements 
that define what will happen when the function main is executed. 
Each group of statements ends with a closing brace (}). 


If functions are like paragraphs, statements are like sentences. 
Notice that each statement ends in a semicolon (;). While C lets 
you string several statements together on the same line, we don’t 
recommend this; it makes programs harder to read. 


Describing The first three statements are 


int bushels; 
float dollars, rate; 
char inbuf [130]; 


Recall that the first step in writing a program is “describing, 
collecting, and storing information.” In C, you must declare each 
item of data before you can do anything else with it. To declare an 
item of data, list what type of data it is, then give it a name. Here, 
you have one item that has an int type (integer, or whole number), 
and is named bushels. You have a second and third item that both 
have a float type (a floating-point number or a number that has a 
decimal fraction), namely dollars and rate. These data items are 
also called variables, since their value can vary according to 
circumstances. And you have a fourth item, a character array, that 
lets you read and store your user’s input. (Arrays are discussed on 
page 97.) 
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Collecting and storing 


Processing 


Printing 


The next six statements obtain and store the data we’ve just de- 
scribed. The printf statements prompt for the number of bushels 
and the number of dollars received for those bushels, and the gets 
and sscanf statements get these values and store them in the 
variables named. Most of the actual work done in a Turbo C++ 
program is accomplished by calling upon functions provided in 
the libraries included with Turbo C++. You call a function by 
giving its name in a statement, along with any information the 
function requires for processing, enclosed in parentheses. printf, 
gets, and sscanf are all library functions. They are not actually 
part of the C language itself. The specifiers %d and %f in the 
sscanf statements indicate that these data items are to be stored 
as an integer and a floating-point decimal, respectively. These are 
called format specifiers; we explain and describe them on page 46. 


The next statement, rate = dollars/bushels, does the processing 
part of the program, dividing the number of bushels by the 
number of dollars to get the dollars per bushel. 


The final statement, again using the printf function, displays the 
results of this calculation. Notice that the printf statement here 
specifies a string (message) followed by a comma and the name of 
the variable rate. The %f specifies that the value should be format- 
ted as a floating-point value. 


When you run the program, the output looks like this: 


How many dollars did you get? 32 
For how many bushels? 24 
You got 1.333333 dollars for each bushel 


Basic structure of a C program 
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Load and run SALESTAG.C. 


This next example demonstrates functions, comments, and the 
preprocessor directives #include and #define. 


/* SALESTAG.C--Example from Chapter 4 of Getting Started. 
SALESTAG.C calculates a sales slip. */ 


#include <stdio.h> 
#define RATE 0.065 /* Sales Tax Rate */ 


float tax (float amount); 
float purchase, tax amt, total; 


int main() 
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char inbuf [130]; 
printf£("Amount of purchase: "); 
gets (inbuf) ; 

sscanf(inbuf, "tf", &purchase) ; 


tax_amt = tax (purchase) ; 
total = purchase + tax amt; 


printf ("\nPurchase is: %f", purchase); 


printf("\n Tax: %f", tax amt); 
printf("\n Total: %f", total); 
return 0; 


float tax (float amount) 


{ 


return(amount * RATE); 


The first line of the program begins with the symbol /*, which 
begins a comment. The symbol*/ ends the comment. Turbo C++ 
ignores all characters between the beginning and end of a 
comment. You use comments to describe the purpose of a 
program, function, or statement. Appropriate comments make it 
easier for you to remember just what a particular part of your 
program does—and it helps other programmers who may be 
called on to modify your program. 


Lines that begin with the number or pound sign (#) are not C lan- 
guage statements, but instructions to Turbo C++ itself. These are 
called compiler directives (or preprocessor directives) because they 
direct the operation of the compiler. The directive #include 
<stdio.h> tells Turbo C++ to read in and compile the contents of 
the file stdio.h, which is one of the many header files (also called 
include files) that Turbo C++ installed for you. These files contain 
descriptions of the library functions (such as printf, gets, and 
sscanf), as well as other items that are part of the standard C 
library. The compiler uses these descriptions to compile the 
program code for the library functions, along with the code for 
your program statements. For more information on each of these 
header files, see Chapter 2, “Run-time library cross-reference,” in 
the Programmer's Guide. 


Another way fo specify The next line, #define RATE 0.065, defines a macro substitution: It 
values thai won t change'§ — tells Turbo C++ that whenever it sees the word RATE in your pro- 
fo use the const keyword, te : 
discussed on page 94, tam code, it is to replace that word with the number 0.065. In a 


longer program, the tax rate may be referred to many times. If the 
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tax rate changes, you need only change the definition and recom- 
pile the program. All of the references will be changed automati- 
cally. This is less time-consuming and more accurate than trying 

to find and change all the references by hand. 


The next statement describes a user-defined function tax, which is 
defined later. The description (called a prototype; see page 81) says 
that this function will accept a floating-point number (float) and 
return a result that is also a floating-point number. Putting the 
description here helps Turbo C++ make sure that your program 
doesn’t try to give the function the wrong kind of data (a char- 
acter string, for example). The statement 


float purchase, tax amt, total; 
describes three floating-point variables. 


The printf, gets, and sscanf statements prompt for and obtain the 
amount of the purchase. Now it’s time for the actual computing. 


tax amt = tax(purchase); 


calls the user-defined tax function. The value of purchase (the vari- 
able in parentheses) is sent to this function. To find out what the 
function does, skip down to the bottom of the program, where 
you see its definition: 


float tax (float amount) 


{ 
return(amount * RATE); 


} 


This specifies that the tax function takes the value of amount that it 
receives, multiplies it by the defined constant RATE, and returns 
the result. Thus, when the line 


tax amt = tax (purchase) ; 


is executed, the tax on the amount of purchase is calculated and 
returned by the tax function, then stored in the variable tax_amt 
for later use. In the next line, in fact, this amount is added to 
purchase to obtain total. 


It may seem unnecessary to have a whole separate function just to 
calculate the tax, and it is in this program. But it becomes useful 
in more complicated situations, such as when there are several tax 
rates to choose from according to the purchaser’s county of resi- 
dence. Perhaps you also have to check a product code to deter- 
mine whether the item is taxable in the first place. In that case, 
separating the mechanism for figuring tax makes the main part of 
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The oufput value of purchase 
doesn't match the input 
value because of how float 
works; see page 40. 


the program easier to follow. If necessary, you can later change 
how the tax is calculated without affecting the rest of the 


program. 


The final three lines of the main program print out the purchase 
amount, tax, and total. A sample run looks like this: 


Amount of purchase: 24.95 


Purchase is: 24.950001 
Tax: 1.621750 
Total: 26.571751 


Clearly some more work will be needed to format your output 
neatly—dollar amounts should have only two decimal places, and 
the amounts should be right-justified. That can wait until you 
learn more about formatting and the printf function, however. (If 
you're concerned about those fractional pennies, Chapter 4, 
“Memory models, floating point, and overlays,” in the Program- 
mer’s Guide has a brief discussion of using the bed class to get 
more precise results.) 


Working with numbers 


Numeric data 
Types 


Numbers are the fundamental data used by computers. As you 
probably know, the actual contents of computer memory consists 
of binary numbers. These are usually organized in groups of 8 bits 
(1 byte) or 16 bits (2 bytes, or 1 word). Even those computing acti- 
vities that involve words or graphics basically involve series of 
numbers stored in memory. 


The same part of memory could be interpreted as several different 
kinds of numbers, depending on how many bytes are grouped 
together. The name of a variable, such as total, actually refers to 
the contents of one or more bytes following a specific address in 
memory—this address is assigned by Turbo C++ when you first 
define (give a value to) the variable. But you and the compiler 
must agree about what kind of number will be represented by a 
given variable, and thus how many bytes will be stored and 
fetched starting at the variable’s address. You make this 
agreement by specifying a data type when you declare the 
variable. For example, 
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Figure 4.1 

Interpreting memory 
locations as numbers (in 
]-byte increments) 
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int total, count, step; 
float cost, profit; 


a i 
int 
float 


baAdcaaeeas 
Sa Ee 000 
1001 


double 


1003 


1004 
1005 


1006 


= 
| 1007 


1007 


Each data type represents a different kind of number. You must 
choose an appropriate type for the kind of number you need. In 
this variable declaration, 


a The variable total is of type int (integer). When you tell your 
program to use the value of total in a statement, it fetches 2 
bytes, starting at total’s address. 


w The variable cost is of type float (floating point). When your 
program uses cost, it fetches 4 bytes, starting at cost’s address. 
(This is because a floating-point number needs the two extra 
bytes to represent the significant digit of the number and the 
magnitude of the number in terms of powers of two.) 


Table 4.1 shows the basic Turbo C++ data types and their 
variations. Notice the variety of numbers that can be 
accommodated. This chapter shows you how to use many of these 


types. 
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Table 4.1: Data types, sizes, and ranges 


Size 
Type (bits) Range 
unsigned char 8 0 to 255 
char 8 —128 to 127 
enum 16 —32,768 to 32,767 
unsigned int 16 0 to 65,535 
short int 16 —32,768 to 32,767 
int 16 —32,768 to 32,767 
unsigned long 32 0 to 4,294,967,295 
long 32 —2,147,483,648 to 2,147,483,647 
float 32 3.4 x 108 to 3.4 x 108 
double 64. = 1.7 x 108 to 1.7 x 1098 


long double 80 3.4 x 10° to 1.1 x 10482 


near pointer 16 Not applicable 
far pointer 32 Not applicable 


Sample applications 

Small numbers and full PC character set 
Very small numbers and ASCII characters 
Ordered sets of values 

Larger numbers and loops 

Counting, small numbers, loop control 
Counting, small numbers, loop control 
Astronomical distances 

Large numbers, populations 

Scientific (7-digit precision) 

Scientific (15-digit precision) 

Financial (19-digit precision) 
Manipulating memory addresses 


Manipulating addresses outside current 
segment 


Integers The basic integer type is int, which can express either negative or 
positive numbers, but within a limited range (-32,768 to 32,767). 


Here’s an example program that performs some operations with 


integers: 


#include <stdio.h> 


main() 


int bags, pounds; 

int total; 

pounds = 50; 

bags = 1000; 

total = bags * pounds; 


printf("There are td lbs. in 1000 bags of beans\n", total); 


return 0; 


The output from this program is a little surprising: 


There are -15536 lbs. in 1000 bags of beans 
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The compiler doesn't warn 
you if you try to store a value 
that doesn't fit into the 
specified data type. 


You'll also need to change 
the %d in the printf statement 
to %id. We explain why on 
page 5]. 


Signed and unsigned 
variables 


To decide which data type 
to use, consider the possible 
results of a calculation or 
other operation. 


since the default for all 
numeric data types is signed, 
you don't have to declare 
signed int or signed long. 
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The total of bags * pounds, 50,000, is too large for an ordinary int 
(which you can verify from Table 4.1). When your program tried 
to store 50,000 in a type that could only hold 32,767, the result 
overflowed. How do you solve this problem? Use long int. 


The long modifier 


long int, which is usually abbreviated just as long, gives you a 
larger integer range. You can solve the problem of the negative 
beans by declaring: 


long total; 


This gives you room for more pounds of beans than you'd ever be 
likely to see, because a long, which is stored in 32 bits instead of 
the 16 used by an ordinary int, can accommodate a value between 
~2,147,483,648 and 2,147,483,647. But what about pounds? This 
variable should be fine as an int, since the weight of one bag is 
unlikely to exceed 32,767 pounds. The variable bags, however, 
might conceivably exceed 32,767, so make it a long also. Why not 
use long instead of int variables for everything? A long takes up 4 
bytes of memory, while an int takes only 2. If you have many 
variables, you'll end up wasting a lot of memory. 


int pounds; 
long bags, total; 


All the data types listed in Table 4.1 are signed by default—one of 
the bits in the stored value is used to indicate whether the number 
is positive or negative. (Those marked unsigned are, of course, 
explicitly unsigned.) Some values encountered in your work can 
be either positive or negative—for example, temperatures and 
bank balances. Many other values, however, are never negative— 
a business can’t have a negative number of employees, for 
example. By adding the word unsigned to any data type, you 
restrict its range to positive numbers. Since a sign bit is no longer 
needed, this doubles the maximum value stored by the type. For 
example, while an ordinary (signed) int ranges from -32,768 to 
32,767, an unsigned int ranges from 0 to 65,535. (An unsigned 
long ranges between 0 and 4,294,967,295.) The preceding program 
example would also have worked correctly if you had declared 


unsigned int total; 


though you'd be getting uncomfortably close to the limits of the 
unsigned int type. 
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Floating-point numbers Many numbers involve a fractional part set off with a decimal 
point, such as prices in dollars and cents. These are called 
floating-point numbers (also often called real numbers). Most exact 
measurements involve fractions: If you buy screws at the hard- 
ware store, you'll probably have to specify the diameter in frac- 
tions of an inch. The float data type covers such situations. Here’s 
an example: 


To try out this program, load /* INTRO2.C--Example from Chapter 4 of Getting Started */ 
and run INTRO2.C. 


#include <stdio.h> 


int main() 

{ 
char inbuf[130]; 
float num, denon; /* numerator and denominator of fraction */ 
float value; /* value of fraction as decimal */ 


printf("Convert a fraction to a decimal\n"); 
printf("Numerator: "); 

gets (inbuf); 

sscanf(inbuf, “Sf", é&num); 
printf("Denominator: "); 

gets (inbuf) ; 

sscanf(inbuf, "Sf", &denom) ; 


value = num / denom; /* convert fraction to decimal */ 
printf("\n Sf / Sf = Sf", num, denom, value); 


return 0; 


} 


The program prompts for the numerator and denominator of a 
fraction, then converts them to a decimal value and prints the 
result. For example, 


Convert a fraction to a decimal 
Numerator: 7 
Denominator: 8 


7.000000 / 8.000000 = 0.875000 


Clearly value must be a float in order to hold a fraction, but you 
may not realize that either num or denom has to be of the float type 
if you wish to divide num/denom correctly. Try this example: 
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If you divide integers by #include<stdio.h> 
integers, the result is rounded 
down to the nearest whole int main() 
number before if is assigned 


to the float variable. 
int num = 3, denom = 4; 


float value; 

value = num / denom; 
printf("\n%f", value); 
return 0; 


} 


The result is a big fat zero—or more precisely, 0.000000, not the 
0.75 you'd expect. 


Double and long double 


The double and long double types are like float, only they 
accommodate larger numbers with more precision. Precision is 
important in both scientific and financial calculations. You might 
want to use your system to print checks for large sums of money, 
such as $125 375,750.75. 


~ €include <stdio.h> 


int main() 


{ 
float amount = 125375750.75; 


printf("\nPay the sum of $f dollars\n", amount); 
return 0; 


When the check is printed out, you'll see 


Pay the sum of 125375752.000000 


The result is an overpayment of $1.25. That may not seem like 
much, but people expect computers to be 100% accurate, 
particularly where money is involved. This error occurred 
because the float type is limited to seven digits of precision, and 
the value assigned to amount has eleven digits, ten nonzero. 
Change amount to a double and run the program again; you'll find 
that the amount is now correct. 
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Variables 


Initializing 
variables 


Assignment 
statements 


As you have learned, every variable must be declared before it 
can be used. A declaration consists of a data type followed by one 
or more variable names. Declarations simply tell Turbo C++ that 
you intend to use a particular variable, and what type of data it 
will store. 


int hours; 
float total pay, pay rate; 
long id number; 


You also need to initialize a variable—set it to a specific value, 
such as 0. What do you think the following program will display? 


#include <stdio.h> 


int main () 

{ 
int something; 
printf("%d", something) ; 
return 0; 


} 


The result will vary—on our machine, it was —32,417. Did you 
notice that the program did not assign any value to the variable 
something before trying to print it out? With the exception of 
global or static variables (discussed later), variables in C do not 
have a default value. (Some languages, such as BASIC, typically 
give numeric variables a default value of 0.) The value of some- 
thing, therefore, is whatever number happens to be stored at the 
address Turbo C++ assigned to the variable. This value is unpre- 
dictable. In fact, if you compiled this program, you might have 
noticed a warning in the Message window: “Possible use of 
‘something’ before definition in function main.” When you get this 
warning, you should check the variable named to make sure you 
initialize it before you use it for anything. 


You give a value to a variable with an assignment statement. 
Assignment consists of a variable name followed by an equals 
sign and the value to be assigned. Here are some examples: 
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Combination 
assignments 


count = 0; 
total = purchase + tax amt; 
tax_amt = tax(purchase) ; 


In the first statement, an actual number, or numeric constant, is 
assigned to the variable count. The second statement uses an 
expression to assign the sum of purchase and tax_amt to the 
variable total. An expression is any combination of values and 
operators (such as + or *) that yield a single value. In C, you can 
use an entire expression just about anywhere that you can use a 
single numeric value. You can assign it to a variable, send it toa 
function for processing, or print it with printf. 


The third statement is slightly more complex: It first calls the 
function tax, giving it the value of the variable purchase. The 
function uses this value and other information to calculate the tax. 
The function returns a value to the calling statement: In other 
words, the function call tax(purchase) is replaced by an actual 
value, such as 1.14. The assignment statement then assigns this 
value to tax_amt. Assignment statements using function calls are 
very common in C. 


C often lets you combine two or more distinct operations in a 
single statement. You can declare a variable and assign it a value 
in a single statement. Instead of 


float total expenses; 
total expenses = 0; 


most C programmers write 
float total expenses = 0; 


You can also assign several variables the same value in one state- 
ment. A word processor might start processing text by setting 


page = line = column = 1; 


This works because an assignment statement not only assigns a 
value, it also provides a value that can be used by other parts of a 
statement in which it is embedded. That is, column = 1 assigns 1 to 
column, and makes this value, 1, available. Moving right to left, 
we get the equivalent of line = 1. In turn, that assignment passes 
on the value 1, so the final assignment is page = 1. 
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But don’t go overboard. It is often better to declare and initialize 
one variable per statement, so you can include a comment 
describing the purpose of each variable: 


int lines = 0; /* Lines of text, ending in new line char */ 

int words = 0; /* Words are groups of characters surrounded */ 
/* by space, tabs, or new lines */ 

int chars = 0; /* Every character is counted */ 


Taking the time to do this might also alert you to potential prob- 
lems. For example, is it really a good idea for chars to be an int? 


Naming names 
It’s time now to consider what names you can give to variables. C 
is quite flexible in this regard. User-supplied names (called identi- 
fiers) must follow these rules: 


m All identifiers must start with a letter (@ to z or A to Z) or an 
underscore (_). 

u The rest of the identifier can use letters, underscores, or digits (0 
to 9). Other characters (such as punctuation marks or control 
characters) cannot be used. 


C++ identifiers are significant The first 32 characters of an identifier are significant. This 
foanylengin. means that 
The_total_amount_of_money_in_my_checking_account 
and 
The_total_amount_of_money_in_my_charge_account 
would be considered by Turbo C++ to be the same variable. Of 
course it would be awkward to use such names, anyway. 


= Identifiers are case-sensitive. This means that amount and 
Amount are completely separate variables. 


By these rules, deduction, tax_status, and amt_1099 are all legal 
identifiers, while 1989_tax and stop! are not. (1989_tax begins with 
a digit instead of a letter or underscore, and stop! contains an 
exclamation point, which is not a letter, underscore, or digit.) 


Besides following the rules, it is important to give some thought 
to naming your variables. Here are some suggestions: 


= The name should describe what the variable contains. a doesn’t 
tell you anything. amt is better, but taxable_amount is most clear 
and specific. 
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Fielding an input 
value: sscanf 


Table 4.2 

sscanf and printf format 
specifiers 

This table also shows printf 
format specifiers, discussed 


on page 49. Note that case 
is important with most format 
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specifiers. 


w Use capital letters or underscores to separate words in a long 
identifier. PricePer100 or price_per_100 are much easier to read 
than priceper100. 


u Use comments to describe the nature and purpose of a variable, 
particularly if it is not obvious. 


You have already seen examples of the use of the gets and sscanf 
functions for obtaining data from the keyboard. You know that 
sscanf stores data in specified variables, and you’ve seen it used 
with different numeric data types (int and float, for example). 
Since different data types are stored differently in memory, you 
need a way to tell sscanf what kind of data you wish to store. So 
let’s look at the anatomy of sscanf more closely. Here is the 
syntax of a call to sscanf: 


sscant(buffer, “format string’, [address, address, ...]) 
Compare this to an actual sscanf statement you've seen before: 
sscanf(inbuf, “%f", &num); 


buffer is the input array where your data was temporarily stored 
by gets. format string contains one or more format specifiers. Format 
specifiers consist of a percent sign (%) followed by a letter indicat- 
ing the type of data to be stored. The group of one or more format 
specifiers is placed between double quotes. For example, %d 
specifies an int value, %f, as in the example just given, expects a 
float, and %s indicates a string of characters. The format string 
%c %d asks for both a single character and an int value. The most 
commonly used formats are shown in Table 4.2. 


Function sscanf printf 
Size of value (modifies data type): 
Specify short integer %hd 
Specify long integer %id %id 
Specify double if Sif 
Use with float to indicate a long double %Lf YoLf 
Type of data to be read or displayed: 
Single character %C %C 
Signed integer %d %d 
Signed double or float in exponential format %e %e 
Signed double or float in decimal format ot “of 
Character string %$S %S 
Unsigned decimal integer %u %u 
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The other necessary part of an sscanf call is the address at which 


the data is to be stored. Every variable in C has a specific address 
in memory. Most of the time you don’t need to worry about 
addresses—you just name the variable to get its value. For 


example, count + 1 evaluates to the current value of the variable 


count plus one. In the case of sscanf, however, you don’t need the 
value of the variable, you need its address. The address operator 


& (the ampersand) is used with a value to get that address. This 
program shows the difference between a variable’s address and 


the value stored there: 


To try out this code, load and 
run INTRO3.C. 


/* INTRO3.C--Example from Chapter 4 of Getting Started */ 


#include <stdio.h> 


int main ()} 


{ 


char inbuf[(130]; 

int number = 10; 

printf ("Address of variable number = %ld\n", &number); 
printf("Value stored at variable number = %d\n", number); 
printf("Enter a new value for the variable: "); 

gets (inbuf) ; 

sscanf(inbuf, "Sd", &number); 

printf("New value stored at variable number = @d\n", number); 


return 0; 


The output looks like this (the address may vary): 


Address of variable number = 65498 

Value stored at variable number = 10 
Enter a new value for the variable: 33 
New value stored at variable number = 33 


The following program illustrates more variations on sscanf: 


To try out this code, load and 
run INTRO4.C. Note how we 
precede calls to sscanf with 

a call to printf or puts that 
describes the value wanted. 
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/* INTRO4.C--Example from Chapter 4 of Getting Started */ 


#include <stdio.h> 


int main () 


char inbuf[130]; 

long transaction number; 
int cashier number; 

char transaction code; 
float purchase amount; 


printf("Enter transaction number: "); 
gets (inbuf) ; 
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sscanf(inbuf, "8ld", &transaction number); 


printf("\nEnter your cashier number: "); 
gets (inbuf) ; 
sscanf(inbuf, "%2d", &cashier number); 


printf("\nEnter transaction type code: "); 
gets (inbuf) ; 
sscanf(inbuf, "%c", &transaction code) ; 


printf("\nEnter amount of purchase: "); 
gets (inbuf) ; 
sscanf(inbuf, "sf", &purchase amount) ; 


return 0; 


} 


The first sscanf statement will read a long (long int) of not more 
than eight digits, while the second sscanf statement will read an 
int of not more than two digits. (In a real application, you would. 
have to perform further error checking. For one thing, if you type 
in more digits than are specified, sscanf simply starts storing 
them in the next variable specified, or ignores them if there are no 
more variables, as in this example.) 


You can ask for the values of more than one variable in the same 
call to sscanf; for example, 


gets(inbuf); 
sscanf(inbuf, "S8ld %2d", &transaction number, &cashier number); 


combines the first two sscanf calls in the preceding example. 
Since only one call to gets is made, only one line of input is read. 


By default, sscanf assumes the user will separate numeric vari- 
ables with spaces. You can include other separator characters in 
the format string; in which case, you must type in each value 
exactly as entered: 


#include <stdio.h> 


int main() 
| 
char inbuf[(130]; 
int hours, minutes, seconds; 
printf("Enter new time in hh:mm:ss "); 
gets (inbuf) ; 
sscanf(inbuf, "Sd:sd:sd", g&hours, éminutes, &seconds) ; 
return 0; 
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Displaying a 
variable’s value 


The number of digits includes 
the decimal point. %6.2f, for 
example, prints five digits, 
two of which are to the right 
of the decimal point. 


The counterpart to sscanf, which gets a value for a variable, is 
printf, which displays the value of a variable onscreen. A call to 
printf consists of the following: 


printf(“format string”, item, item, ...) 


format string can contain optional text to be displayed. If you’re 
displaying the values of one or more items (variables, expressions, 
constants, and so on), you must include a conversion specification 
for each item. These conversion specifications are analogs of the 
format specifiers discussed with sscanf earlier, but there are addi- 
tional features for formatting the output. The specifier consists of 
a percent sign followed by a symbol for the type of data involved. 


Earlier you used printf statements to display a purchase amount, 
tax, and total: 


printf("\nPurchase is: %f", purchase); 
printf ("\n Tax: sf", tax amt); 
priate (\n Total: tf", total); 


The results were displayed like this: 


Purchase is: 24.950001 
Tax: 1.621750 
Total: 26.571751 


How can you set up the conversion specifier to make Turbo C++ 
display these values properly aligned with only two decimal 
places (which is appropriate for dollar amounts)? Here’s one 
solution: After the % sign, put a number to indicate total digits 
you want displayed, followed by a period and the number of 
decimal places you want. 


printf ("\nPurchase is: $%6.2f", purchase) ; 
printf("\n Tax: $%6.2f£", tax amt); 
printf ("\n Total: $%6.2f", total); 


This displays the values as 


Purchase is: $ 24.95 
Tax: § 1.62 
Total: $ 26.57 


The next example shows how printf can display several types of 
numbers in different formats: 
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To try ouf this program, load 
and run INTROS.C. 
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/* INTRO5.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 
| 
int int num = 999; 
float float_num = 99.99895; 
long double big num = 1250500750.75; 


printf ("12345678901234567890\n") ; 
printf ("td\n", int num); 
printf("séd\n", int num); 
printf£("sf\n", float num); 
printf ("%6.3f\n", float num); 
printf("$e\n", big num); 
printf("sLe\n", big num); 


return 0; 


} 
Here is the output: 


12345678901234567890 
999 

999 
99.998947 
99.999 
~3.95361e-207 
1.250501e+09 


The first printf statement prints 20 digits as a ruler to show how 
the other numbers line up. It also illustrates that printf doesn’t 
have to print the value of a variable or expression—it can print 
just a text string if you desire. The next statement prints the value 
of int_num (999) as is. The third statement specifies a 6-digit field; 
since the default is right-justification, the number 999 is displayed 
three spaces over from the left. (If you specify a field width too 
small for the number of whole digits in a number, the specifica- 
tion will be overridden and the full number of digits displayed. 
This is sensible: It means that 999 won’t be displayed as 99 just 
because you made an error and specified %2d.) 


The next two statements display the value of float_num. In the first 
statement, the value isn’t exactly correct: 99.998947 is displayed, 
rather than 99.99895. This is because the float type declared for 
float_num guarantees seven digits of precision, but printf by de- 
fault tries to print as many digits as it is given to the left of the 
decimal point, plus six digits to the right of the decimal point, 
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even if some of the digits end up inaccurate. For many applica- 
tions, this small difference may not matter, but it is important to 
realize that when you have exceeded the precision for the data 
type involved, having printf show more digits buys you no 
accuracy and may even mislead the user. 


To avoid the display of spurious digits, use a precision specifier to 
specify how many digits you want after the decimal point. The 
next statement specifies %6.3f, which includes a maximum field 
width of six and a decimal precision of three places. When the 
precision is less than the number of digits available, the last digit 
is rounded up or down as appropriate. 


Type conversion in _ printf uses the conversion specifier to try to convert the value to 
printf whatever type is specified, regardless of the actual data type of 
the value. For example, if you have a float variable dollars and use 
Do not specify more digits the specifier %d, the value 24.95 will end up as 0 or some seem- 
fhan the datatype can ingly random number because printf will read 2 bytes (an int) 
accurately hold. yather than 4 (float) starting at the address of dollars. On the other 
hand, if you declare a variable as an int, then try to display it with 
%f, you will also get a wrong result because printf will try to read 
4 bytes from a 2-byte variable. 


printf is a complicated function with a large amount of code for 
handling the various formats. Turbo C++ links in the part of the 
code that handles floating-point values only if you use floating 
point in your program. If your program never uses a floating- 
point type, and you use the %f specifier with an int, you will get a 
run-time error message telling you that the floating-point formats 
were not linked. A more compact and readable alternative to 
printf and sscanf is provided by the C++ streams library, 
discussed in Chapter 5. 


The preceding example uses the %e specifier to display big_num, 
which was declared to be of type long double. Unfortunately, the 
specifier tries to print this as an ordinary double, again producing 
a nonsense value with a huge negative exponent. The last state- 
ment uses the specifier %Lf, which correctly specifies long double. 


Formatting with There are a number of characters that control how text appears 
escape\ sequences onscreen; for example, the tab character advances the cursor to 
the next tab position, the newline character moves the cursor to 
the next line, and the formfeed starts a new screen or page of text. 
printf lets you include any of these characters (and others) in the 
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text to be printed, simply by prefixing the symbol for the char- 
acter with a backslash (\). The backslash is called an escape because 
it tells Turbo C++ to interpret the following character not as a 
literal n or f or whatever, but as the symbol for a special character. 


Indeed, you have already seen numerous examples using \n ina 
string being displayed with printf. While the print statement in 
languages such as BASIC automatically advances the cursor or 
print head to the next line, there is no such default in C. This gives 
you more flexibility, since you can use separate printf statements 
to display text on the same line, and advance to the next line only 
when you specifically wish to. The next table lists Turbo C++’s 
escape sequences. 


Table 4.3 
Character escape Sequence Name Meaning 
REARS “NG Alert Sounds a beep 
\b Backspace Backs up one character 
The octal and hexadecimal \f Formfeed Starts a new screen or page 
escape sequences are = \n Newline Moves to beginning of next line 
different from Turbo C 2.0. \r Carriage return Moves to beginning of current line 
See Chapier I, “ihe Turbo \t Horizontal tab § Moves to next tab position 
C++ language standard," in \vy Vertical tab Moves down a fixed amount 
the Programmers Guide for \\ Backslash Displays an actual backslash 
aefails.  \¢ Single quote Displays an actual single quote 
\" Double quote Displays an actual double quote 
\? Question mark —_ Displays an actual question mark 
\OOO Displays a character whose ASCII code 
is an octal value (one to three digits) 
\xHHH Displays a character whose ASCII code 
is a hexadecimal value (one or more 
digits) 


a “Newline” on MS-DOS systems is equivalent to a carriage 
return (CR) plus a linefeed (LF). This is not true of some other 
systems. 


m A backslash in front of the single and double quotes is needed 
only when Turbo C++ would otherwise interpret these 
characters as having a special meaning. For example, " 
normally delimits a string. To print a string in quotes, use "\"a 
string in quotes\"", 

m The octal or hexadecimal values are often used to send special 


graphics characters or printer control characters. For example, 
printf ("\xDB") on the IBM PC displays a solid square character. 


After \n, the most commonly. used escape sequence is probably \t, 
the tab character. It is useful for aligning tables of numbers. For 
example, this code 
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To try this out, load and run /* INTRO6.C--Example from Chapter 4 of Getting Started */ 
INTRO6.C. 


#include <stdio.h> 


int main() 

{ 
int i = 101, j = 59, k = 0; 
int m= 70, n= 85, p= 5; 


int gq = 39, r = 110, s = 11; 


printf ("\tWon\tLost\tTied\n\n"} ; 

printf ("Eagles\t%3d\t33d\t%3d\n", i, j, k); 
printf ("Lions\t%3d\t%3d\t%3d\n", m, n, p); 
printf ("Wombats\t%3d\t%3d\t%3d\n", gq, r, 8s); 


return 0; 


produces the following neatly formatted table: 


Won Lost Tied 


Kagles 101 99 0 
Lions 70 85 5 
Wombats 39 110 11 


Arithmetic 


operators Now that you know how to get and display values for different 
kinds of variables, let’s look more closely at the variety of 
operators provided by Turbo C++. You have already seen several 
operators: the assignment operator (=) and four arithmetic 
operators (+, —, *, and /, for addition, subtraction, multiplication, 
and division, respectively). 


These operators work pretty much the way you would expect 
them to, though with some differences: For example, dividing two 
int values gives you an int result, with any fraction dropped. 
There is also a specific order, called precedence, in which operators 
take effect. For arithmetic operators, multiplication and division 
come before addition and subtraction. Try to guess the four num- 
bers that will be displayed by this program (to try it out, load and 
run INTRO7.C): 


Chapter 4, An introduction fo C 53 


lt doesn't hurt to use 
parentheses, even if they 
aren't strictly needed. They 
can make expressions easier 
to read. 


modulus (%) 
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/* INTRO?.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 

{ 
float result; 
result = 1.0 + 2.0 * 3.0 / 4.0; 
printf("Sf\n", result); 
result = 1.0 / 2.0 + 3.0; 
printf("$f\n", result); 
result = (1.0 + 2.0) / 3.0; 
printf("$f\n", result); 
result = (1.0 + 2.0 / 3.0) + 4.0; 
printf("Sf\n", result); 


return 0; 


} 
Here they are. How did you do? 


2.900000 
3.500000 
1.000000 
9.666667 


In the first expression, the multiplication 2.0 * 3.0 is done first, 
yielding 6. Next, 6 / 4.0 gives 1.5, which is finally added to 1.0 to 
get the final result, 2.5. Notice that when operators have equal 
precedence (* and / have equal precedence, as do + and -), 
operations are done from left to right. 


In the second expression, the division is done first, then the 
addition, so the result is 0.5 + 3, or 3.5. 


In the third expression, (1.0 + 2.0) is in parentheses, so it is 
performed first: The result, 3.0, is then divided by 3 to get 1. 


Finally, the last expression places 1.0 + 2.0 / 3.0 within paren- 
theses. Within the parentheses, the usual rules are followed: 2 is 
divided by 3, and then added to 1. The result, 1.666667, is then 
added to 4 to get 5.666667. 


The modulus operator (%) divides two numbers and keeps only 
the remainder. For example, the expression 5 % 2 gives a result of 
1, while 18 % 3 gives 0, since 3 divides evenly into 18. 
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Arithmetic and 


type Conversion What happens if you add an int to a float? You would want the 
result to be a float so that any fractional part is retained, and that 
is what happens. Turbo C++ promotes smaller types to larger ones 
according to a set of rules (see the next table). From the table, you 
can see that when an int and a float are added, the Int is promoted 
to a float. The two numbers are then added, resulting in a float. 


Table 4.4 
Type promotions for 
arithmetic 


Some types in this fable have 
not been discussed yet. 


Type 


Converts to 


These types are converted automatically: 


char 

unsigned char 
signed char 
short 
unsigned short 
enum 

float 


int 

int 

int 

int! 

unsigned int! 
int 

double 


Then these rules are applied, until both operands have the same type: 


If either operand is... 


long double 
double 

float 
unsigned long 
long 

unsigned 


The other 1s converted to... 


long double 
double 

float 
unsigned long 
long 

unsigned 


'This is an ANSI requirement. However, short and int are the same size for all C 
compilers on the PC, so no conversion is done. 


Typecasting It is sometimes useful or necessary to explicitly convert a data 
item to a specified type. For example, if you have 
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#include <stdio.h> 


int main() 


{ 


int a = 5, b = 2; 
printf("$d", a / b); 


return 0; 
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Combining 
arithmetic and 
assignment 


Increment and 
decrement 


you'll get a result of 2, since integer division drops any fractional 


part. If, however, you do it this way: 


#include <stdio.h> 


int main() 

{ 
int a= 5, b = 2; 
printf("Sf", (float) a / (float) b); 
return 0; 


the values a and b will be converted to the type enclosed in 
parentheses (float in this case) before the division, so the value of 
the expression will be 2.5. This forced conversion is called a type 
cast, or just a cast. 


A common operation in programming involves adding a fixed 
amount to a variable (incrementing it). For example, if a program is 
counting words, when it finds a word, it will do something like 
total_words = total_words + 1. Later, you will also see how loops 
usually involve repeatedly adding or subtracting a number until a 
variable reaches a specified limit. | 


A shorthand way of doing things in C is to perform arithmetic 
and assignment in one step. You can combine any binary arith- 
metic operator with the assignment operator. The preceding 
statement can also be written as total words t= 1. Read this as 
“add 1 to the current value of fotal_words and assign this quantity 
as the new value of total_words.” Similarly, a checkbook-balancing 
program might execute the statement balance -= check amt (sub- 
tract the amount of the check from the balance and make that the 
new value of balance). The somewhat less common combinations 
*= and /= work in the same way. 


Adding and subtracting exactly one is so common an operation 
that two special operators, increment (++) and decrement (— —), 
are provided for the purpose. Thus ++total_words does exactly the 
same thing as total words += 1. A program that does a countdown 
for the space shuttle might use count-- in a loop until zero is 
reached. 


Turbo C++ Getting Started 


Working bit by bit 


The increment and decrement operators can come either before or 
after the affected variable. When the operator comes before the 
variable it is applied to the variable first, and then the result is 
used in the expression as a whole. When the operator comes after 
the variable, the value of the variable is used first, and then the 
operator is applied to the variable. For example, 


#include <stdio.h> 


int main{) 
int val = 1; 
printf("val is $d and then post-incremented\n", valt++); 
printf("val is now %d\n", val); 
printf("val is pre-incremented to %d\n", +t+val); 
return 0; 


} 


which gives the results 


val is 1 and then post-incremented 
val is now 2 
val is pre-incremented to 3 


In the first printf statement, val is still 1 when it is printed, but 
becomes 2 afterward, as shown in the second printf. In the third 
statement, val is incremented first, so it is 3 by the time it is dis- 
played by printf. 


Sometimes you'll find that you have to manipulate the actual bits 
that make up each byte in memory. C provides a set of bitwise 
operators, shown in the next table. 
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Table 4.5 
Bit manipulation operators 


Operator Meaning 


Operators that take two operands: 


& AND; if both bits are 1, result is 1. 

| OR; if either bit is 1, result is 1. 

A Exclusive OR; if only 1 bit is 1, result is 1. 

>> For a signed int, shift bits right the number of times 


specified by following number; fill in 1s at left if the 
number is negative, 0s if positive. For an unsigned int, 
fill in Os to left. 

<< Shift bits left the number of times specified by following 
number; fill in zeros at right. 


Operator that has a single operand (unary operator): 
~ 1’s complement; reverse all bit values. 


The following program illustrates the use of these operators: 


#include <stdio.h> 


int main() 

{ 
printf("1 ¢ 1 is d\n", 1 & 1); 
printr(").) 1 4s: éd\n",. 1. | 1) 
printt ("1 *.1 ts: sd\n",-12* 
print£("255 << 2 is d\n", 255 << 2); 
printf£("255 >> 2 is $d\n", 255 >> 2); 
printf("*255 is tu\n", ~255); 
return 0; 


Remember that the integer 1 is stored in 2 bytes as 00000000 
00000001, while 255 is 00000000 11111111. Here is the output: 


1é1is1 
dt od aes. 


is 
11 as: 0 

255 << 2 is 1020 
255 >> 2 is 63 
~255 is 65280 


Notice that the & operator gives 1 only if the corresponding bits 
are both 1. This makes it useful for masking off selected bits of a 
value by using a bit pattern that has zeros in the positions you 
wish to turn off. The | operator turns on a bit if either or both 
values have a 1 in that position. If you want to guarantee that a 
certain bit is on, “OR” that value with a value that has a 1 in that 
position. 
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The fourth statement left-shifts the value 255 twice (00000000 
1111111 becomes 00000011 11111100). Since each place in a binary 
number is two times the preceding place, this is equivalent to 
multiplying 255 * 2 * 2, or 1020. In the next statement, 255 is 
right-shifted twice, so 00000000 1111111 becomes 00000000 
00111111, or 63. Finally, the last statement turns 00000000 
11111111 into 11111111 00000000. This is equivalent to 65,535 — 
255, or 65,280. 


Expressions 


You have now seen a variety of statements that use expressions, 
so this is a good time to review how expressions work in general. 
Remember that an expression is any combination of variables, 
defined constants, or literal numbers which together with one or 
more operators yield a single value and possibly produce one or 
more side effects. Thus 


purchase * TAX RATE 
dollars / bushels 
count++ 

STATUS & SWITCH ON 


are all examples of expressions. An expression can be assigned to 
a variable with the assignment operator (=). It can be displayed by 
printf in the same way as a single variable. The preceding 
program, for example, used statements such as 


print£("255 << 2 is d\n", 255 << 2); 


Evaluating an 


expression Turbo C++ evaluates expressions by applying the operators invol- 
ved in order of their precedence, starting first with any parts of 
the expression that are enclosed in parentheses. Table 4.6 lists all 
of the C operators in order of their precedence and associativity. 
Associativity is the direction in which the compiler evaluates the 
operators and operands. For example, the various assignment 
operators (=, +=, *=, and so on) associate from right to left 
(assigning the expression on the right to the variable on the left), 
while the arithmetic operators (*, /, +, -, and %) associate from left 
to right. 
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Precedence is the order in which evaluations are done. For 
example, multiplication is done before addition, so that the 
statement 


count = 5 +3 * 4 
results in 17, not 32. 


The best way to become familiar with these rules is to use an 
expression with a printf statement so you can see the result, then 
check the table to see how that result was arrived at. (As an alter- 
native, Chapter 7, “Debugging in the new IDE,” shows how you 
can use the built-in Turbo C++ debugger to evaluate many kinds 
of expressions.) 


The rules of precedence and associativity are as follows: 


m Unary operators (operators with only one operand, such as ++) 
have a higher order of precedence than binary operators (such 
as /). 


mw Arithmetic operators come ahead of comparison operators. 


w Greater than and less than come ahead of equals and not- 
equals. 


= Comparison operators come ahead of bit manipulation 
operators (except for left and right shifts). 


a Bit manipulation operators come ahead of logical operators. 
m Logical AND (&&) comes ahead of logical OR (||). 


mw Everything except for the comma operator comes before 
assignment operators. 
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Table 4.6 
Precedence and 
associativity of operators 


Operators, precedence, and 
associativity are explained in 
full in Chapter 1, “The Turbo 
C++ language standard,” in 
the Programmers Guide. 


Assigning a value 
In an expression 
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Operators Associativity 
(){] —- : . Left to right 
[~+— ++ —-— & * (typecast) sizeof new delete Right to left 
* —>* Left to right 
* 1 % Left to right 
pe te Left to right 
<< >> Left to right 
< <= > >= Left to right 
ee Left to right 
& Left to right 
ik Left to right 
| Left to right 
&& Left to right 
{| Left to right 
?: (conditional expression) Right to left 
=*= /= %= ¢= —= &= Az |= «<e= >d= Right to left 
: Left to right 


You have been seeing examples of the assignment operator used 
in a complete statement, such as the initialization of a variable, 
total = 0. Assignment statements like total = count = line = 0 
remind us that every assignment is also an expression. What do 
you think this program will display? 


#include <stdio.h> 


int main() 
int val; 
printf ("Sd\n", val = 7); 
return 0; 


If you guessed 7, youre right. The value of an assignment state- 
ment as an expression is the value assigned. 


You have also seen that a call to a function that returns a value 
has that value. For example, total += tax(total) is equivalent to 


tax amt = tax(total); 
total = total + tax amt; 


The first form eliminates the extra variable at the cost of being a 
bit more cryptic. 
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Characters and strings 


Inout and output 
for single 
characters 
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There’s more to life than numbers. It’s time to look at characters 
and character strings. As you probably know, a character— 
whether an uppercase or lowercase letter of the alphabet, a 
numeral, a punctuation symbol, a carriage return, or Cirl-C—is 
stored as a single byte (8 bits). The values for characters are 
assigned by the ASCII (American Standards Committee for Infor- 
mation Interchange) code. The first 128 values are pretty much the 
same throughout the industry, but IBM PC-compatible machines 
use the second 128 values (128 to 255) for special graphics and 
line-drawing characters. In C, you use the type char (which 
means the same as Signed char) to access the values from 0 to 127, 
with room for negative values for special purposes (such as 
indicating an error or the end of a file). If you want to access the 
full character set of the PC, use the type unsigned char. 


Here is one way to get a character from the keyboard and store it 
in a variable (to try it out, load and run INTRO8.C): 


/* INTRO8.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 
char inbuf[130]; 
char one char; 
printf("Enter a character: "); 
gets (inbuf) ; 
sscanf(inbuf, "%c", gone char); 
printf("The character you entered was %c\n", one char); 
printf("Its ASCII value is %d\n", one char); 


return 0; 


} 
A sample run looks like this: 


Enter a character: A 
The character you entered was A 
Its ASCII value is 65 
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Remember that you need 
the address of one_char, so 
you must prefix one_char 
with the & (address of) 
operator. 


This one Is INTROY.C; load 


and run It to see how It works. 


Displaying a 
character 


one_char is a variable of type char. The sscanf statement uses the 
specifier %c to indicate a single character, and stores the entered 
value in one_char. The next statement displays the value of 
one_char (notice the %c conversion specifier for printf). The next 
printf statement prints the ASCII code for the entered character. It 
does this by using the %d conversion specifier. This converts the 
character value to its ASCII code. A character is an integer, but 
certain facilities in C (such as the %e specifier) display the value 
as a character rather than as an integer. 


An alternate way to get a character from the keyboard is to use 
library functions getch or getche. The previous program could be 
rewritten as follows: 


/* INTRO9,.C--Example from Chapter 4 of Getting Started */ 


#include <stdio.h> 
#include <conio.h> 


int main() 
int one char; 
printf("Enter a character: "); 
one char = getch(); 
printf("\nThe character you entered was %c\n", one char); 
printf("Its ASCII value is $d\n", one char); 


return 0; 


With this version of the program, the character you type won’t be 
displayed onscreen. If you want the entered character to be 
visible, use getche instead. gets reads in an entire line of text 
before letting the program continue, while getch and getche read 
one character, then continue. 


This example also shows one way to display a character onscreen. 
The %e conversion specifier is used with printf to display a single 
character. Another way to display a single character is with the 
library function putch, which is defined in the header file conio.h. 
putch(’>’) displays the specified literal character >. If one_char is a 
variable of type char (or, in some cases, of type int), putch(c) 
displays the value of one_char as a character. 
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Displaying 
character strings 


Figure 4.2 
How a string is stored in 
memory 


Important! 


A string is a series of characters. You have already seen strings 
used in printf statements. For example, 


printf("Enter a character: "); 


calls printf and tells it to display a string of characters beginning 
with an E and ending with a space. The double quotes tell Turbo 
C++ to treat the group of characters as a string. Each character is 
stored in a consecutive byte of memory, and printf receives the 
address of the first character. How does printf know when it has 
reached the end of the string? Whenever you define such a literal 
string, Turbo C++ invisibly tacks a null character on the end. This 
character has an ASCII value of 0, and is represented symbolically 
as \0. The next figure shows how a string is stored in memory. 


Starting address null character 
| o string 


mintifs| lifs| [t{hfel [vialifulel lot] Im{slahniol | [| 


[ 23 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 2 2 27 28 2 30 


Position 
char message[30]; 
rhe ave “This is the value of msg\n’); 


message is actually a pointer to a location for the string. Therefore, 
the code 


message = "This is the value of msg\n"; 


makes message point to where that string is. It does not copy the 
literal string into the storage area of message. This is why you 
must use strepy to copy the characters of the string to the 
variable. 


For convenience, Turbo C++ also provides the library function 
puts. This function writes a string to the standard output, 
normally the screen. Thus puts ("Enter a character: ") works 
almost the same as the printf statement just described, with one 
exception: puts automatically puts a new line (\n) at the end of the 
string, advancing the cursor to the next line. If your program 
doesn’t need the advanced formatting capabilities of printf, you 
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can save considerable program space by using the simpler puts to 
display strings. 


There is an important difference between double quotes and 
single quotes for specifying strings and characters. 


a “a” is a string consisting of one character, a, and the invisible 
null character 


m ‘a’ is the single character a. 


Since strings and characters are different data types, specifiers or 
functions that work with strings do not work with characters, and 
vice versa. To display “a”, use printf with %s or puts; for ‘a’, use 
printf with %c or putch. 


Testing conditions and making choices 


Using relational 
operators 


Table 4.7 
Relational operators 


You have now learned many elements of the C language. So far, 
all programs have run straight through from beginning to end. 
Often, however, programs must make choices based on certain 
values. For example, consider this code fragment: 


if (bill > credit limit) 
puts("Consult with the manager"); 


If the amount of the bill is greater than the amount of the credit 
limit, the code displays the message about consulting with the 


_ manager. 


The > (greater than) operator in the preceding statement is a 
relational operator. It expresses a relationship between two 
values—in this case, whether bill is greater than credit_limit. 
Computers use a simple two-valued logic: If a relationship is true, 
it has a value of 1; if it is false, it has a value of 0. The relational 
operators are listed in the next table. 


Operator Meaning Example 
> Greater than 5>4 
>= Greater than or equal to 5 >= x 
< Less than 4<5 
<= Less than or equal to x<=5 
== Equal to Se 
I= Not equal to 5 l= 4 
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To try out this program, load 
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and run INTRO 10.C. 


Using logical 
operators 


This simple program shows you how relational operators can be 
used: 


/* INTRO10.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 
{ 
char inbuf[130]; 
int first, second; 
printf("Input two numbers\n"); 
gets (inbuf); 
sscanf(inbuf, "%d $d", &first, &second); 
printf("first > second has the value %d\n", first > second); 
printf("first < second has the value %d\n", first < second); 
printf("first == second has the value %d\n", first == second); 


return 0; 


} 


Here’s a sample run, using the values 3 and 5 (be sure to typea 
space between the 3 and the 5): 


Input two numbers: 

first > second has the value 0 
first < second has the value 1 
first == second has the value 0 


Notice that a relational test is an expression, since it gives a value. 
Thus, it can be displayed by printf, and you can assign it to a vari- 
able with a statement like hot = (temperature > 90). Be careful not 
to confuse == (the relational equals operator) with = (the assign- 
ment operator). Try editing the last statement in the example so 
that it reads | 


printf("first == second has the value $d\n", first = second) 


The expression first = second evaluates to the value of second, or 5 
in the sample run. The if, for, and other statements that test condi- 
tions consider any nonzero condition to be true. You can see that 
using = where you meant == will cause inappropriate program 
behavior (such as being stuck in an endless loop). 


You can combine more than one condition in a test. To do so, use 
one of the three logical operators shown in the next table. 
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Table 4.8 ; 
Logical operators Operator Meaning 


&& AND (both conditions must be true) 
\| OR (at least one condition must be true) 
| NOT (reverse the truth value of a condition) 


For example, the conditional expression 
(employee type == temporary) && (wage > 6.00) 


is true only if the employee is a temporary and his or her wage is 
over $6.00 an hour. C is efficient at handling these operators: If the 
first condition (employee type == temporary) is found to be false, the 
second condition isn’t tested, since an AND expression is false if 
either condition is false. 


The expression 
(employee type == temporary) || (employee type == hourly) 


is true if either of the two conditions is true. Thus if the first 
condition is found to be true, there’s no need to test the second. 


Branching with if 


and if...els@ Now that you've surveyed relational and logical operators, it’s 
time to put them to work. The simple if statement takes the form 


if (conditional expression) 
statement or group of statements; 


The condition can be a single relational expression or a combina- 
tion of expressions joined by logical operators. It must be enclosed 
in parentheses. The if statement acts according to the true or false 
value from the conditional expression. If the expression is true, 
the statement or group of statements that follow is executed. If 
you want a group of statements to be executed, enclose them in 
braces. The following program uses two if statements to tell you 
whether the number you entered is odd or even: 


To try out this code, load and /* INTRO11.C--Example from Chapter 4 of Getting Started */ 
run INTROTT.C. 


#include <stdio.h> 


int main() 
{ 
char inbuf[130]; 
int your number; 
printf(“Enter a whole number: "); 
gets (inbuf) ; 
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sscanf(inbuf, "%d", &your number); 

if (your number % 2 == 0) 
printf("Your number is even\n"); 

if (your number % 2 != 0) { 
printf("Your number is odd.\n"); 
printf("Are you odd, too?\n"); 

} 

printf("That’s all, folks!\n"); 


return 0; 


} 


After prompting for and storing your_number, the program uses 
an if statement to test whether the number is even, using the 
modulus (%) operator. (Since all even numbers are evenly divi- 
sible by 2, any even number mod 2 gives a result of 0.) If the num- 
ber is even, the first printf statement is executed. The second if 
statement tests whether your_number is odd, that is, if it has a 
nonzero remainder when it’s divided by 2. If the number is odd, 
you see the following: 


Your number is odd. 
Are you odd, too? 


Both printf statements are executed, since they are grouped 
together with a set of braces. Finally, the message “That’s all, 
folks!” is displayed. Since it isn’t part of an if statement, it is 
executed regardless of whether your_number is even or odd. 


Multiple choices 


with If...elS@ The previous example probably looked awkward to you. Ifa 
number is even, it can’t be odd, so why make two separate tests? 
This example can be rewritten much more compactly by adding 
an else branch to the if. The if ... else statement has this form: 


if (conditional expression) 
statement or group of statements; 

else 
alternative statement or group of statements; 

Applying this to the previous example, you get 
To Try out this progr am, load /* INTRO12.C--Example from Chapter 4 of Getting Started */ 
and run INTRO 12.C. 
#include <stdio.h> 


int main() 
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char inbuf[{130]; 

int your number; 

printf("Enter a whole number: "); 
gets (inbuf) ; 

sscanf(inbuf, "td", &your number) ; 


if (your number % 2 == 0) 
printf ("Your number is even\n"); 
else { 
printf ("Your number is odd.\n"); 
printf("Are you odd, too?\n"); 
} 
printf("That’s all, folks!\n"); 


return 0; 


} 


You can nest if and else clauses as deeply as you wish, although 
after a few dozen nested if statements the compiler is likely to run 
out of memory. Suppose you had to write a program that allo- 
cated computers to employees, subject to the following 
conditions. 


a If your employees are programmers and have been working at 
least two years, give them an 80386 PC. 


a If your employees are programmers and have been working less 
than two years, give them an 80286 PC. 


w If your employees have been working at least two years, but 
aren’t programmers, give them an 8088 PC. 


= Finally, if your employees don’t meet any of these conditions, 
give them a Macintosh. 


Try to map out how you could specify these conditions with if 
and else statements. Here’s one way: 


if (employee type == PROGRAMMER) { 
if (years worked >= 2) 
give employee (PC386) ; 
else 
give employee (PC286) ; 


else if (years worked >= 2) 
give employee (PC88) ; 
else 
give employee (Mac) ; 


Notice how we used indentation to show which conditions 
depend on other conditions. First the program determines 
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To try out this code, load and 
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Multiple choice 
tests: switch 


run INTRO T3.C. 


whether the employee is a programmer. If so, it checks the num- 
ber of years worked, and awards the appropriate computer. If the 
employee isn’t a programmer, the outer if...else statement checks 
the number of years worked, and awards the machines assigned 
to nonprogrammers of varying seniority. 


A long series of if and else if statements is tedious to write, con- 
fusing, and prone to error. Consider the next program, which has 
to decide how to graph a set of data based on the character the 
user has entered in response to a menu. Here’s one way to do it: 


/* INTRO13.C--Example from Chapter 4 of Getting Started */ 


#include <conio.h> 
#include <stdio.h> 
#include <ctype.h> 


int main() 
{ 


char cmd; 


printf("Chart desired: Pie Bar Scatter Line Three-D"); 
printf("\nPress first letter of the chart you want: "); 
cmd = toupper(getch()); 


printf ("\n") ; 
if (cmd == 'P!) 

printf("Doing pie chart\n"); 
else if (cmd == 'B!) 


printf("Doing bar chart\n"); 
else if (cmd == 'S!) 

printf ("Doing scatter chart\n"); 
else if (cmd == 'L’) 

printf ("Doing line chart\n"); 
else if (cmd == 'T!) 

printf("Doing 3-D chart\n"); 
else printf ("Invalid choice.\n"); 


return 0; 


} 


The program displays a menu line, then gets a value for cmd via 
the getch function. Along the way, the value is passed to the 
toupper function. This ensures that you only need to deal with 
uppercase characters. The series of if and else if branches then test 
for each valid value and execute the corresponding function. The 
last else serves as the default case, handling invalid values. 
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The switch statement makes these multipath branches easier to 
code. It uses the form 


switch(value) 
The ... means that you can { 


have as many case clauses aoe a 
as you want. case value : statement or group of statements 


default : statement or group of statements 


} 


The value is tested against the value for the first case. If they are 
the same, the program code given after the colon for the first case 
is executed until the end of the switch statement or until the 
special statement break is reached. If they are different, the value 
for the next case is tested, and so on. If none of the values are the 
same as the switch value, the statement or group of statements 
following default is executed. The default is optional. If you don’t 
supply one, and no condition is met, then no statements within 
the switch are executed. 


The preceding program example can be rewritten using a switch 
as follows: 


To try out this program, load /* INTRO14.C--Example from Chapter 4 of Getting Started */ 
and run INTRO 14.C. 


#include <stdio.h> 


int main() 
{ 


char cmd; 


printf("Chart desired: Pie Bar Scatter Line Three-D"); 
printf("\nPress first letter of the chart you want: "); 
cmd = toupper(getch{)); 

printt("\n"); 


switch (cmd) 

{ 
case 'P’; printf("Doing pie chart\n"); break; 
case 'B’: printf("Doing bar chart\n"); break; 
case 'S': printf("Doing scatter chart\n"); break; 
case 'L!: printf("Doing line chart\n"); break; 
case 'T’: printf ("Doing 3-D chart\n"); break; 
default : printf("Invalid choice.\n"); 

} 


return 0; 


The break statement at the end of each case is very important. It 
causes execution to jump past the end of the switch statement. 
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You usually want to include a break statement as the last state- 
ment for each case. For example, remove the break at the end of 
the statement for case ‘L’ and run the program again. If you 
select L, you'll see 


Doing line chart 
Doing 3-D chart 


The statements for both the L and T cases are executed. In other 
words, if you leave out the break, execution continues until it 
finds a break or the end of the switch statement. 


Sometimes this behavior can be useful. Suppose that you want the 
user of your program to be able to use either D (for delete) or E 
(for erase) to remove the current file. You could then code 


switch (cmd) 
case ‘I’: insert file(); break; 
case 'F’; format file(current file); break; 
ease TD" 
case 'E’; erase file(current file); 


Since there is no break statement for case ’D’, erase_file will be 
executed for this case as well as for case ’E’. 


Repeating execution with loop 
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The while loop 


The most significant characteristic of the if, else, and switch state- 
ments is that they perform their test only once, and execute what- 
ever statements are specified only once. But many computer tasks 
involve repetition; they involve instructions such as “use the same 
process on each item in this file until you get to the end of the file” 
or “use the same process on each item in this set of data.” For this 
kind of task, you'll want to use a loop. Loops cause a statement or 
series of statements to be executed repeatedly, monitoring a 
specified condition in order to determine when to stop. C 
provides three kinds of loops: while, do, and for. 


The while loop executes one or more statements as long as a 
specified condition is true. The syntax is 


while (condition) 
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statement or group of statements; 


The following program lets you enter numbers from the key- 
board. It keeps a running total. When you enter a 0, it gives you 
the total and average of the numbers entered. 


To try out this example, load /* INTRO15.C--Example from Chapter 4 of Getting Started */ 
and run INTRO 15.C. 


#include <stdio.h> 


int main() 


{ 
char inbuf[130]; 


int number; /* Number entered by user */ 
int total .= 0; /* Total of numbers entered so far */ 
int count = 1; /* Count of numbers entered */ 


printf("Enter 0 to quit\n"); 

/* Priming statement puts a value into number */ 
gets (inbuf) ; 

sscanf(inbuf, "Sd", &number) ; 


while (number != 0) 
{ 
total += number; 
gets (inbuf); 
sscanf(inbuf, "$d", &number); 
if(number == 0) 
printf("Thank you. Ending routine.\n"); 
else counttt; 


} 
printf("Total is $d\n", total); 
printf ("Average is d\n", total / count); 


return 0; 


} 


Once the first number is entered, it is tested by the while. As long 
as the number isn’t 0, three things are done: 


a The number just entered is added to fofal. 
a A new number is obtained with sscanf. 


= That number is tested. If it isn’t 0, the count of numbers is 
incremented by one. 


The do while loop 


The do while loop is very similar to the while loop. It takes the 
form 


do statement or group of statements 
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while (condition is true) 
important! What's the difference between a do while and a while loop? 


u The while loop performs the test first and executes the enclosed 
statements only if the result of the test is true. 


u The do while loop executes the enclosed statements and then 
performs the test. This means that the enclosed statements are 
performed at least once, even if the test turns out to be false. 


A good situation for using the do while loop is processing a menu. 
The earlier menu examples had the drawback that they only 
executed once, and then unceremoniously dumped the user out of 
the program. Here is the menu program rewritten to use a do 
while statement: 


To try out this example, load /* INTRO16.C--Example from Chapter 4 of Getting Started */ 
and run INTRO 16.C. 


#include <conio.h> 
#include <ctype.h> 
#include <stdio.h> 


int main() 
{ 


char cmd; 


do { 
printf("Chart desired: Pie Bar Scatter Line Three-D 
Bec) 
printf("\nPress first letter of the chart you want: "); 
cmd = toupper(getch()}); 
printf ("\n"); 


switch (cmd) 

{ 
case 'P’: printf("Doing pie chart\n"); break; 
case 'B’; printf("Doing bar chart\n"); break; 
case ’S’; printf("Doing scatter chart\n"); break; 
case 'L’: printf("Doing line chart\n"); break; 
case 'T’:; printf("Doing 3-D chart\n"); break; 
case 'E!: break; 
default : printf("Invalid choice. Try again\n"); 


} 
} while (cmd != ’E’); 


return 0; 


} 


What has changed? The active part of the program, including the 
statements that display the menu and get a character as well as 
the switch statement, have been enclosed in a do while loop. An 
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The for loop 
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additional menu case, E, allows the user to exit the program. This 
case simply has a break associated with it. If any other character 
(including an invalid character) had been typed, the while condi- 
tion causes the menu to be redisplayed. But if E (or e) is typed, the 
condition cmd != ’E’ is false, and control drops out of the bottom 
of the do while loop. The program then terminates. 


The for loop steps through a series of values, performing the 
specified actions once for each value. The form for this statement 
is 

for (starting values; condition; changes) 


statement or group of statements; 


} 


The following for loop displays the visible characters from the 
PC's character set (load and run INTRO17.C): 


/* INTRO17.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 
{ 
int ascii val; 
for {ascii val = 32; ascii val < 256; ascii valtt) 
{ 
printf("\t%c", ascii val); 
if (ascii val % 9 == 0) 
Prince ao) 
} 


return 0; 


The variable ascii_val is the counter variable for the for loop. The 
initialization (starting) value is ascii_val = 32. The condition 
ascii val < 256 is the limit for the loop. The change that is made in 
the counter variable is ascii_val++ (in other words, it is incre- 
mented by one each time through the loop.) 


The printf and if statements are enclosed by braces and make up 
the body of the loop. The printf statement displays the character 
corresponding to the current value of ascti_val, using a tab char- 
acter (\t) for spacing. The if statement begins a new line whenever 
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Some programmers put the 
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semicolon on a separate 
line, so if will stand out. 


To try this out, load and run 
INTRO T9.C. 


asciit_val is evenly divisible by 9—in other words, it ensures that 
each row will have 9 characters. 


There are many variations on the theme of for loops. The body of 
the loop can have only one statement, in which case the braces are 
optional but recommended for clarity. A for loop can have no 
body at all, with all of the work being done in the change part of 
the control statement. For example, this loop totals up the num- 
bers from 1 through 10 (load and run INTRO18.C): 


/* INTRO18.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 
{ 
int number, total; 
for (number = 1, total = 0; number < 11; total += number, 
numbert++) ; 
printf("Total of numbers from 1 to 10 is $d\n", total); 


return 0; 


} 


This example also shows that the starting and change parts of the 
loop specification can have multiple expressions, separated by 
commas. The loop initializes two variables, number and total. Each 
time the loop runs, it adds number to total and then increments 
number. 


The semicolon following the closing parenthesis represents the 
empty body of the loop. If it is omitted, the loop will grab the 
printf statement and execute it repeatedly, treating it as the body. 
A for loop could be written instead as a while loop. The previous 
example could be rendered as 


/* INTRO19.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main({) 
{ | 
int number = 1, total = 0; 
while (number < 11) { 
total += number; 
numbert+t; 
} 
printf("Total of numbers from 1 to 10 is %d\n", total); 


return 0; 
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The while loop performs its initialization before the loop begins, 
and updates the counter variable within the body of the loop. The 
for loop performs both of these operations within the loop specifi- 
cation itself. The for loop is more compact, but it can be harder to 
read if you cram too many expressions between the parentheses. 


Break and 


CONTINUE Sometimes it’s necessary to bail out of the statements in a loop 
even before you test the condition again. The break statement has 
two different uses: to break out of a switch statement after state- 
ments provided for a particular case have been executed, and to 
exit a while, do while, or for loop immediately, without perform- 
ing the rest of the statements enclosed in the loop. For example, 
suppose you didn’t want to launch a space shuttle if any warning 
lights were on: 


To try out this program, load /* INTRO20.C--Example from Chapter 4 of Getting Started */ 
and run INTRO20.C. : 


#include <stdio.h> 
#define WARNING -1 


int get_ status (void) 
return WARNING; 


int main() 
{ 
ine count = 104 
while (count-- > 1) 
{ 
if (get_status() == WARNING) 
break; 
printf ("Sd\n", count); 
if (count == 0) 
printf("Shuttle launched\n"); 
else 
printf("Warning received\n") ; 
printf("Count down held at t - Sd", count); 


return 0; 


A while loop runs the countdown, each time checking the func- 
tion get_status to see if it returns a value of -1 (which you have 
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defined as WARNING). This function would presumably be 
reading the warning system in real time. If get_status returns —1 
at any time during the countdown, break stops the countdown. 
Following the while statement, the if statement checks to see if 
count reached zero. If it did, then no warning occurred. If count is 
greater than 0, however, the countdown must have been inter- 
rupted, and the shuttle is not launched. 


The continue statement, like break, causes all remaining state- 
ments in the loop to be skipped. But while break completely exits 
the loop, continue simply skips to the loop’s test condition. 
INTRO21.C displays the even numbers up through 10: 


To try out this program, load /* INTRO21.C--Example from Chapter 4 of Getting Started */ 
and run INTRO21.C. 


#include <stdio.h> 


int main() 
{ 
int num = 0; 
while (num++ <= 10) 
{ 
if (num % 2 != 0) 
continue; 
printf ("Sd\n", num); 


return 0; 


} 


If the number is odd, the continue statement causes the printf 
statement to be skipped. 


continue isn’t used very often. You have to think the problem 
through to see when a continue or a break is appropriate. The use 
of continue inside the while loop in the space shuttle program 
would not be a good idea, since not only would the countdown 
not be displayed (the printf statement in the loop would be 
skipped), but also count would continue down to 0, since the 
decrement is part of the condition (count-- > 1). The shuttle 
would be launched even if a warning had been received. 


The goto 


statement Veteran BASIC or FORTRAN programmers are familiar with the 
goto statement. C has this statement, too. It has the form 


goto label 
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where label is an identifier that is associated with a particular 
statement. When goto is executed, control jumps to the labeled 
statement. In early BASIC, goto was a necessity because there was 
no other way to code a loop. With C’s three kinds of loops, and 
the use of break and continue to skip parts of loops when neces- 
sary, there is little need for a goto statement. Modern program- 
mers avoid goto because it makes a program hard to read and 
modify. It is too easy to forget why the jump to a particular 
statement was made. Besides, no language has ever provided a 
wherefrom statement. 


Nested loops 


One of the statements in the body of a loop can be another loop— 
this is called nesting. In this example, a while loop accepts strings 
that you enter, and the for loop prints hyphens under the string in 
order to underline it. 


To try out this code, load and /* INTRO22.C--Example from Chapter 4 of Getting Started */ 
run INTRO22.C. 


#include <stdio.h> 
#include <string.h> 
#include <conio.h> 


int main({) 
{ 
int pos; 
char text [40]; 


printf("Type ‘end’ to quit\n"); 


while (strcmp (gets(text), “end") != 0) { 
for (pos = 1; pos <= strlen(text); postt) 
putch(!="); 
printt ("\n"); 
return 0; 


This is an example of the powerful but compact style of veteran C 
programmers. To figure out how the while loop is controlled, read 
from the inside out. gets(text) gets the input string and stores it in 
the character array text. This function also returns the string it has 
fetched to the calling statement, so that that string can now be 
compared to the string “end” by the stremp function, which com- 
pares two strings. If the comparison yields a 0, the strings are 
identical, the user had typed end, and the loop exits. Otherwise, 
the body of the while loop is executed. The first statement of the 
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Choosing 
appropriate loops 


body is a for loop that prints a number of hyphens equal to the 
length of the string that was originally entered, using the strlen 
function to find out how long it was. The printf statement, which 
ends the body of the while loop, positions the cursor for entry of 
the next line. 


You have now seen three different ways to code loops (while, do 
while, and for). Use whichever form of statement expresses the 
idea of the program most clearly, keeping in mind the following 
guidelines: 


m If you don’t want the body of the loop to be executed at all if 
the condition is false, use a while loop. 


m If you want the body of the loop to always be executed at least 
once, use a do while loop. 


m If the number of times the loop is to be executed is determined 
by the value of a variable or constant, it is usually best to use a 
for loop. 


m If the loop is to be executed as long as some externally deter- 


mined condition is true (for example, as long as there is data 
left in the file), use a while loop. 


Program design with functions and macros 


Defining your Own 
functions 
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Now that you know how to control the execution of a program, 
you can do some useful work in C. We encourage you to modify 
and elaborate upon the example programs. Small, simple pro- 
grams such as the ones we've covered so far don’t need a lot of 
structure. However, as your programs grow larger and more 
complex, you need to break them down into smaller, more 
manageable logical pieces, or functions. 


The programs you have already seen perform divisions of labor. 
When you call gets, puts, or strcmp, you don’t have to worry 
about how the innards of these functions work. These and about 
400 other functions are already defined and compiled for you in 
the Turbo C++ library. To use them, you need only include the 
appropriate header file in your program and check the online help 
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The function prototype 


Note that main, as a function 
itself, must also conform to 
the ANSI recommendation 

that all functions be given 
prototypes. 


We recommend that you use 
prototypes in your code. 


or Chapter 1, “The run-time library,” in the Library Reference to 
make sure you understand how to call the function, and what 
value (if any) it returns. 


But you'll need to write your own functions. To do so, you need 
to break your code into discrete sections (functions) that each 
perform a single, understandable task for your program. Once 
you have declared and defined your own functions, you can call 
them throughout your program in the same way that you call 
Turbo C++ library functions. 


Function prototypes are a key feature of the new ANSI standard 
for the C language. A function prototype is a declaration that takes 
this form: 


return_type function_name (parameter_type parameter_name ...), 
Here are some examples: 


int main (void) 

float tax(float purchase) ; 

char get employee type(int employee num); 
char get_choice(void); 

int getch (void); 

void show menu(void); 


By looking at the prototype, you can tell exactly what type of 
information the function expects, and what type it returns. 


Let’s look at tax. When you call it, you need to give it a floating- 
point number. The result will also be floating point. The prototype 
informs Turbo C++ about all this. 


Some of the other example prototypes shown earlier use the key- 
word void. void means empty, or none. When the word void ap- 
pears in the parentheses in place of the parameter list, this indi- 
cates that the function has no parameters. Thus if you tried to use 
the statement show menu(10), you would be informed that 
show_menu doesn’t take any parameters. When void appears as 
the function’s return type, it means that the function does not 
return a value—so you shouldn’t try to assign the function call’s 
result to a variable. 


Function declarations under Kernighan and Ritchie 


In the old Kernighan and Ritchie style, the return type of a 
function was given only if it wasn’t int. Similarly, function 
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The function definition 


Processing within the 
function 
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parameters were declared within the body of the function 
definition, rather than in the parameter list. The 
get_employee_type function would be declared in this old style 
as | 


char get_employee type(); 
And the function’s actual code (its definition) would look like this 


char get_employee type (employee num) 
int employee num; 
{ 


/* body of function code */ 


Old-style functions compile correctly under Turbo C++. However, 
they have less information about the function’s parameters, so 
errors involving the wrong type of parameters in function calls 
won’t be caught automatically. This is one of the many good 
reasons why this older style is being discarded by ANSI. 


The function definition contains the actual executable code for the 
function. The preferred form for the function header starts out 
exactly the same as the function declaration, except that it doesn’t 
end in a semicolon. It is followed by local variable declarations 
and the code to be executed, enclosed in braces. 


float tax(float purchase) 
float tax_rate = 0.065; 
return(purchase * tax rate); 


The function sees its parameters as though they had been de- 
clared as variables of the indicated types. The tax function thus 
has access to two values: its float parameter, purchase, and its own 
float variable, tax_rate. If you make the function call tax (amount), it 
is a copy of the value of amount that the function tax receives 
through its parameter purchase. The function refers to this value 
under the name purchase and can change the value of purchase. 
This doesn’t change the value of the original variable amount, 
however. We’ll show you later how a function can use pointers to 
change the values of variables used to call it. 
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The function return A function doesn’t have to return a value—in that case, you 
value should declare its return type to be void. To return a value to the 
caller, a function uses the return statement (as in the function tax, 
where the value returned is purchase * tax_rate). The next figure 
summarizes how information flows to the tax function and then 


flows back again. | 
Figure 4.3 
/*function declaration*/ 
Information flow to and from The value of amount is float tax(float purchase) 
the tax function assigned to corresponding “ 
parameter purchase f*calling statement*/ 


tax_amt = tax(amount); 


The value is now available 
within function tax under the return(purchase + tax_rate); 
name purchase 


The return statement sends the 

calculated value back to the calling tax_amt = tax(amount); 
statement, where it replaces the 

function call tax(amount) 


In calling statement, returned value 
is assigned to the variable tax_amt tax_amt = (value returned) 


Using the return value The returned value of a function can be treated like any other 
value in an expression. It can be combined with other variables 
and arithmetic operators in an expression; it can be part of the 
condition for an if statement or loop; it can be assigned to a 
variable, and so on. Here are some examples of the use of function 
return values that you have already seen: 


tax amt = tax (purchase); 
if (get_status() == WARNING) 
while (stremp(gets(text), “end") != 0) 


In the first example, the value returned by the tax function is 
assigned to the variable tax_amt. In the second example, the value 
returned by the call to get_status is compared with the defined 
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Multifunction 
programs 


Be sure fo set your path 


argument in calls to initgraph 


to the directory where your 


.BGI files are. 


After reading through the 
cliscussion of this program, 
feel free to modify it. Sfudy 


the graphics library. Try differ- 


ent colors and fill styles. 
Experiment with various 


scaling values for distances 
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and radii. 


value WARNING; the result determines the true value of the if 
statement. In the last example, the value returned by gets is 
passed to the stremp function (along with the string “end”), and 
the result of the call to stremp in turn is compared with zero. That 
result becomes the value of the while statement test. 


The following program draws a graphic representation of part of 
the solar system. It illustrates the use of several user-defined 
functions as well some features of Turbo C++’s graphics library. 
(For more on how to use Turbo C++ graphics, see Chapter 5, “Vi- 
deo functions,” in the Programmer's Guide.) 


As written, the program requires EGA or VGA graphics 
hardware, but because it scales itself to the capabilities of the 
adapter, you could run a cruder version in CGA if you change the 
color constants used. The output is shown in the next figure. | 


The program listing has function prototypes, global declarations, 
the definition for main, and then the definitions of the various 
other functions. This program is included on your disk as 
PLANETS.C. 


/* PLANETS.C--Example from chapters 4 and 7 of Getting Started */ 


#include <graphics.h> /* For graphics library functions */ 
#include <stdlib.h> /* For exit() */ 

#include <stdio.h> 

#include <conio.h> 


int set_graph(void); /* Initialize graphics */ 
void calc coords (void) ; /* Scale distances onscreen */ 
void draw planets (void); /* Draw and fill planet circles */ 


/* Draw one planet circle */ 
void draw planet (float x pos, float radius, 
int color, int fill style); 
void get_key(void); /* Display text on graphics screen, */ 
/* wait for key */ 


/* Global variables -- set by calc coords() */ 


int max xX, max y; /* Maximum x- and y-coordinates */ 

int y org; /* Y-coordinate for all drawings */ 

int aul; /* One astronomical unit in pixels 
(inner planets) */ 

int au2; /* One astronomical unit in pixels 
(outer planets) */ 

int erad; /* One earth radius in pixels */ 

int main({) 


Turbo C++ Gefting Started 


/* Exit if not EGA or VGA */ 
/* Find out if they have what it takes */ 
if (set_graph() != 1) { 
printf("This program requires EGA or VGA graphics\n") ; 


exit (0); 
calc coords ()}; /* Scale to graphics resolution in use */ 
draw planets (); /* Sun through Uranus (no room for others) */ 
get_key(); /* Display message and wait for key press */ 
closegraph(); /* Close graphics system */ 
return 0; 


int set graph (void) 
int graphdriver = DETECT, graphmode, error code; 


/* Initialize graphics system; must be EGA or VGA */ 
initgraph(&graphdriver, &graphmode, "..\\bgi"); 
error code = graphresult(); 
if (error code != grOk) 

return (~1); /* No graphics hardware found */ 
if (({graphdriver != EGA) && (graphdriver != VGA)) 
{ 

closegraph (); 

return 0; 


void calc coords (void) 


{ 
/* Set global variables for drawing */ 


max x = getmaxx(); /* Returns maximum x-coordinate */ 
max y = getmaxy(); /* Returns maximum y-coordinate */ 
y org = max y / 2; /* Set Y coord for all objects */ 
erad = max x / 200; /* One earth radius in pixels */ 
aul = erad * 20; /* Scale for inner planets */ 

au2 = erad * 10; /* scale for outer planets */ 


void draw planets () 

{ 
/* Each call specifies x-coordinate in au, radius, and color */ 
/* arc of Sun */ 
draw planet (-90, 100, EGA YELLOW, EMPTY FILL); 
/* Mercury */ 
draw planet (0.4 * aul, 0.4 * erad, EGA BROWN, LIBKSLASH FILL); 
/* Venus */ 
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return(1); /* Graphics OK, so return "true" */ 
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Function prototypes 
and global 
declarations 


draw planet (0.7 * aul, 1.0 * erad, EGA WHITE, SOLID FILL); 

/* Earth */ 

draw planet (1.0 * aul, 1.0 * erad, EGA _LIGHTBLUE, SOLID FILL); 
/* Mars */ 

draw planet (1.5 * aul, 0.4 * erad, EGA_LIGHTRED, CLOSE DOT FILL); 
/* Jupiter */ 

draw planet (5.2 * au2, 11.2 * erad, EGA WHITE, LINE FILL); 

/* Saturn */ 

draw planet (9.5 * au2, 9.4 * erad, EGA LIGHTGREEN, LINE FILL); 
/* Uranus */ 

draw planet (19.2 * au2, 4.2 * erad, EGA GREEN, LINE FILL); 


void draw planet (float x pos, float radius, int color, int 
fill style) 
{ 
setcolor (color); /* This becomes drawing color */ 
circle(x pos, y org, radius); /* Draw the circle */ 
setfillstyle(fill style, color); /* Set pattern to fill interior 
/ 
floodfill(x pos, y org, color); /* Fill the circle */ 
} 


void get_key(void) 

{ 
outtextxy(50, max _y - 20, “Press any key to exit"); 
getch(); 


This program calls five programmer-defined functions. Their 
declarations appear right after the #include statements. These 
declarations could appear elsewhere, but then there wouldn’t be 
any type checking until the prototypes are reached. It is easiest to 
have them right at the start. The prototypes of void and non-int 
functions must appear before the first call to those functions. 


The global variables hold information needed for drawing the 
planets. Their values are calculated by the cale_coords function, 
and these values are used by draw_planets. Making these 
variables global (rather than declaring them inside a function) 
makes them accessible to both functions that need them. Later, 
we'll show an alternate way to share variables between two 
functions. 
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Setting up the graphics 
display 


Calculating the 
graphics coordinates 


main’s first call is to set_graph, which “packages” a number of 
operations involving the Turbo C++ graphics library. set_graph 
uses the library function initgraph with the DETECT mode to 
automatically determine what kind of graphics hardware is 
present. Notice the multiple return statements—a function can 
have as many return statements as needed. The first If determines 
whether there was an error initializing the graphics system (the 
code returned isn’t equal to grOk (“graphics OK”)—the function 
exits and returns an error code in that case. The second test 
returns an error code if neither EGA nor VGA capability is present. 
The second test is made only if the first was successful. The use of 
multiple return statements avoids the need for else statements. 


The identifiers DETECT and grOk appear not to have been 
declared anywhere. In fact, these are defined constants that are 
part of the graphics.h header file. In addition to function 
prototypes, header files frequently make useful definitions 
available to your programs. We recommend that you browse 
through graphics.h and other header files that you frequently use 
in your programs, so that you become familiar with their 
contents. All of the colors and pattern fill styles you’ll encounter 
later are also defined in graphics.h. Each identifier has an integer 
value associated with it, but the use of symbolic names makes it 
much easier to see what is going on. (BLACK is much more 
meaningful than 0.) 


main checks the value returned by set_graph. If anything other 
than 1 was returned, the program displays a message and exits. 


If everything checks out, cale_coords is called next. Many begin- 
ning programmers are used to thinking of the x-y dimensions of 
the graphics screen as being fixed by those provided by the 
graphics adapter they use—for example, 640x350 for EGA. The 
temptation is to hard-code these exact dimensions into your 
program. But this leads to trouble when the program is run ona 
machine that has a different graphics resolution and set of 
available colors. As discussed further in Chapter 5, “Video func- 
tions” of the Programmer's Guide, the graphics library helps you 
write programs that run on a wide range of graphics adapters. 


To help make this possible, the library functions getmaxx and 
getmaxy functions return the highest x- and y-coordinates, 
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Drawing the planets 


respectively, for the graphics mode currently set. (This in turn was 
set by Initgraph.) The remaining statements 


m set the center for the planetary circles by taking half of the 
maximum y value. 

m scale the Earth’s planetary radius (which is the unit used to 
express the radii of the other planets) to 1/200th of the width of 
the screen (the maximum <x value). 


m set two distance measurements for placing the centers of the 
circles on the x-axis. Because distances in the solar system 
increase rapidly once past Mars, different scales are used for the 
inner and outer planets. As a result, the drawing won’t be accu- 
rate in distances, though it will accurately show the relative 
sizes of the planets. (Due to the limited size of the screen, you 
can’t have both.) For the same reason, Neptune and Pluto had 
to be omitted. 


The function draw_planets gathers together a series of calls to the 
function draw_planet, which does the actual work. draw_planet 
takes four parameters: x_pos, radius, color, and fill_style. 


™ X_pos is the x-coordinate for the center of the planetary circle. It 
is obtained by multiplying the distance unit (au1 or au2) by the 
mean distance of the planet’s orbit from the sun, expressed in. 
astronomical units. (An astronomical unit is the distance of the 
Earth from the Sun, approximately 93 million miles.) 

w radius is the radius for the planetary circle. This is obtained by 
multiplying the actual planet’s radius in terms of Earth’s radius 
(about 4,000 miles) by erad, the number of pixels per Earth 
radius. 

w color is a constant from graphics.h that gives the color to be 
used for drawing the circle (and for filling it in) from the default 
EGA palette (which also works for VGA). 


mw fill_style is a constant from graphics.h that gives the style to be 
used for filling in the circle. 


draw_planet takes these parameters and calls Turbo C++ graphics 
library routines to draw the circle and fill it in. Notice that the 
y-coordinate needed by circle and floodfill didn’t have to. be 
supplied as a parameter. Since it is fixed, the quantity y_org 
previously calculated by cale_coords is used. 
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Header files, 
functions, and 
libraries 


Figure 4.4 
simple program structure (all 
in one) 


Header files usually only 
contain function 
declarations so they can be 
included in many different 
source or module files. 


Finally, get_key uses the outtext library function to display a 
message, then calls getch, which waits for a key to be pressed to 
exit the program. 


In a small program, you will probably declare and define your 
functions in the same file, together with your main function that 
ties everything together. Such a structure is shown in the next 


figure. 


#include 


As programs get larger, however, it becomes desirable to group 
related function definitions in a separate file. For example, the 
functions dealing with the user interface might go into one file, 
the functions dealing with data processing in another, and the 
functions dealing with presentation graphics in yet a third file. 
Turbo C++ can compile all three files together to create the final 
executable program. This kind of structure is shown in the next 


figure. 
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Figure 4.5 
Program built from several #include 
files #define 


int main(void) 


"Main program logic*/ 


Main program 


Subtasks 
(files compiled separately) 


_—~ 


Menu Graphics Calculations 
Module 1 Module 2 Module 3 
/*menu.c*/ *graphics.c*/ Fcales.c*/ 
(Function declarations*/ Function declarations*/ Function declarations*/ 
You could substitute an void menu(void); void bar_graph(int_); float rate_of_return_; 
#include "header.h" "Function definitions*/ (Function definitions*/ Function definitions*/ 
command for the function void menu(void); void bar_graph(int_) float rate_of_return 
declarations. 


- . = 


Once parts of your program are stable, you can compile groups of 
functions into libraries. The declarations for the functions in each 
library can be put into a header file like those you use to access 
Turbo C++’s own libraries. Your main program includes the 
header files, thus inserting the function declarations into your 
program text. After compilation, the linker links the libraries into 
your program’s object code. This process is shown in the next 


figure. 
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Figure 4.6 Header files 


Program using custom anh #includ 
no include 

panes f* declarations */ ae include --------- 

#include menu.h 


graphix.h #include graphix.h 
F declarations */ #include calcs.h 
a int main(void) 
calcs.h { 
/* declarations * - compiled code 


of main function } 


Precompiled libraries 


Trevose evecare oreeare 
CHC 
SOR RO 

CORO RO 


menu.|lib 


scope and 


Curation of As programs get more complicated, the question of access to 
variables variables used in other parts of the program arises. Every variable 
has two characteristics: scope and duration. Scope (sometimes 
called visibility) defines what parts of a program can access the 
variable. Duration specifies how long the variable remains 
accessible. 


scope Scope is determined by where you declare the variable. A variable 
defined within a function definition is by default local—it can only 
be accessed by code within the same function. For example, in this 


program, 
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You can load and run this 
program: INTRO23.C. 


/* INTRO23.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 
void showval (void); 


int main() 

{ 
int mainvar = 100; 
showval (); 
printf ("$d\n", funcvar); 


return 0; 


} 


void showval (void) 

{ 
int funcvar = 10; 
printf("Sd\n", funcvar); 
printf ("Sd\n", mainvar); 


} 


the function showval first uses a printf statement to display the 
value of funcvar. This is fine, since funcvar is declared and defined 
within the showval function. The next statement, which attempts 
to display the value of mainvar, causes the compiler to complain 
(by way of an error message) that mainvar is undefined. This is 
because mainvar is defined within another function, namely main. 
It cannot be accessed from within showval. 


Even if you fix this, upon return from the call to showval, the 
main function tries to display the value of the variable funcvar. | 
This, too, will cause an error because funcvar is defined within 
showval. 


To make a variable visible from within any function in the current 
source file, define it outside any function definition. It will be 
visible after the position in the source file where it is declared, so 
the usual place to define such global variables is before the start of 
the definition of main. If the preceding example starts out like 
this, 


void showval (void); 
int mainvar, funcvar; 


and if you remove the int declaration from 


int mainvar = 100 and 
int funcvar = 10, 
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Duration 


To try out this code, load and 
run INTRO24.C. 
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there will be no complaint. Remember, however, that a variable 
that is accessible from anywhere is also changeable from 
anywhere, which can lead to bugs that are hard to track down. 
Changes in value caused this way are sometimes called side effects. 


By default, global variables are accessible from any file. 
(Although, without extern references in other files, a global 
variable has file scope.) If you have a program that uses more 
than one source file, and you need to make a variable visible in a 
different source file, declare it in the current file by adding the 
keyword extern (“external”). Thus, if the file main.c defines 

int xscale, you can “see” this variable from within another file 
(such as stars.c) by declaring 


extern int xscale; 


there. The variable is assigned its memory address when it is 
originally defined. The extern declarations merely inform the 
compiler that an external variable will be referenced. 


It would be inefficient to reserve memory permanently for all of 
the variables in a large program. After all, a particular function 
may only be called once. By default, variables declared within a 
function definition are auto (automatic) variables. Their memory 
is allocated when their function begins to execute. When the 
function returns to its caller, the memory is freed up for use by 
other variables. 


Occasionally you may wish to override this default behavior and 
have a variable stored permanently, even when the function it is 
declared in isn’t running. The keyword static accomplishes this. 
For example, a function could count how many times it was 
called: 


/* INTRO24,C--Example from Chapter 4 of Getting Started */ 


#include <stdio.h> 
#include <conio.h> 


void tally (void); 


int main() 
{ 
while ( getch() != 'q!)} 
tally(); 


return 0; 
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Using constant 
values 


void tally (void) 
{ 

static int called = 0; 

calledt+t; 

printf("Function tally called $d times\n", called); 
} 


Each time the while loop in main receives a character other than g 
from getch, it calls tally. tally increments the static variable called 
on each call. C initializes static numeric variables to 0 when they 
are declared. 


Another declaration keyword that is occasionally used is register. 
When it is added to a variable declaration, register asks the com- 
piler to generate code that uses one of the microprocessor’s fast 
internal registers to hold the value, rather than using the slower 
random access memory. register can only profitably be used with 


data types small enough to fit in a register, such as char or int. 


Since modern compilers such as Turbo C++ optimize so that they 
take advantage of machine resources efficiently, only experienced 
programmers know when to take advantage of this feature. Using 
it inappropriately can slow down your program. It is usually best 
to let the compiler figure out whether to use a machine register 
for a variable. Also, using the keyword register doesn’t guarantee 
that the variable will be saved in a register. It is only a suggestion 
to the compiler that it attempt to do so. 


A constant is a value that is fixed—it doesn’t change during the 
execution of your program. There are two ways to define 
constants: the const keyword and the #define directive. 


1. One way to create constants is to use the keyword const in a 
declaration. For example, if you declare 


const float cm per_inch = 2.54 


you are telling the compiler that this value will never change. 
If you attempt to assign a new value to it anywhere in your 
program (including by incrementing or decrementing it with 
++ or --), you will receive an error message. Using this key- 
word therefore helps Turbo C++ to catch programming slips. 


2. Another way to include constant values in a program is by 
using the #define directive. You have already seen a few 
examples, such as 
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#define RATE 0.065 


This is not a declaration, but an instruction to the preproces- 
sor, a part of Turbo C++ that will make requested changes to 
your source code before it is compiled. Here, the change is 
equivalent to using a word processor to find all instances of 
RATE and replace them with the characters 0.065. 


There are times when either const or #define is more appro- 
priate. In both cases, you can change the value by simply 
changing the definition and recompiling. const gives the 
important advantage that Turbo C++ knows what data type 
the value should have (for example, const Int). On the other 
hand, a #define can appear in multiple modules without 
problems, but const float can’t. 


The advantage of using constants is that when the value 
changes, you need change only this one statement. You don’t 
have to search for every instance of a particular number—a 
process which, besides being tedious, is prone to error. 


Using macros to 


hide details #define can do more than simplify substitution. You can design 
macros that take parameters (much in the same way as functions) 
and embed them in a template of text. For example, 


You can load and run this /* INTRO25.C--Example from Chapter 4 of Getting Started */ 
program: INTRO25.C. 
#include <stdio.h> 


Programmers usually use the #define EVEN(value) (((value) % 2 == 0) ? (value) : ((value) + 1)) 


? : expression for macros. 
int main() 


{ 
char inbuf[130]; 
int num; 
printf("Enter a number: "); 
gets (inbuf) ; 
sscanf(inbuf, "$d", é&num); 
printf ("\ntd", EVEN(num)); 


return 0; 


The exira parentheses Jn the statement printf ("\n$d", EVEN (num)), the definition causes 
one pai habe ,, the expression EVEN(num) to be replaced in the program text by 
expressions, the following: ((num) % 2 == 0) ? (num) : ((num) + 1). In other 
words, whatever term is used in parentheses replaces the name 
value each place that it occurs within the template. The resulting 
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Functions are usually smaller 


The tradeoff between 
functions and macros is 
speed versus space. 


but slower than macros. 


lf you use a macro, make 
sure the value being 
substituted is of the 
appropriate type. 


expression evaluates to num if it is evenly divisible by 2 ((num) % 2 
== 0); otherwise, it is odd and is replaced by (num) + 1, making it 
even. 


The EVEN macro could be written as a function, of course: 


int even (int num) 


{ 
return (num % 2 == 0 ? (num) : (num + 1)); 
} 


While the macro and the function are called in the same way, the 
way they work is actually quite different. For a macro, the 
template with the inserted value replaces the call to the macro in 
the actual source code before compilation. With a function, the 
code for the function is compiled, and the function call is 
compiled into code that passes the appropriate value(s) on the 
stack and then jumps to the function’s code. The code for the 
function itself is compiled only once, no matter how many times 
the function is called. With the macro, new source code is inserted 
into the file each time the macro is called. 


Macros make the source code more readable by replacing a com- 
plicated expression with an easy to recognize name. A number of 
“functions” in the run-time library are really macros; for example, 
the character classification routine isalpha which checks to see 
whether a character is part of the alphabet as opposed to being a 
digit, punctuation mark, and so on. You can study this and a 
number of other macro definitions by looking at the header file 


ctype.h. 


Building data structures 
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Data tends to come in bunches rather than single pieces. For 
example, you may need to keep track of the number of hours an 
employee has worked each week during the current year. Here 
you have a set of related data items of the same type (total hours, 
probably a float to allow for fractional hours). C allows you to 
declare an array to store such a set of homogeneous data. But your 
business also has to keep track of a variety of information about 
each employee, such as name, years worked, salary, department, 
and so on. These items are certainly related (they all refer to an 
employee), but they are of different types. Names are character 
strings (arrays of characters), years worked can be an int or a float 
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Figure 4.7 
Two ways to deal with sets of 
data 


Note that the different 
members of a structure may 
not always be contiguous in 

memory. 


depending on whether fractions are allowed, the salary is pro- 
bably a double (to allow for well-paid employees), and the 
department can be a numeric code or a character string. 


float hours[52]; 
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typedef struct { 
char name[40]; 
int dept_no; 
float rate; 
float hours; 

} employee; 


A structure 


dept_ no hours 


_fhame[40] { 
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Memory addresses (relative) 


In addition to organizing your data, you need a way that you can 
easily find the particular item you want to work with. Since all 
this data is actually stored in blocks of memory addresses (some- 
thing like house addresses on a street), you can point to the data 
you want by using addresses. In this section, you'll learn how to 
use pointers to access data structures. 


Declaring and initializing an array 
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An array is a chunk of memory that is used to hold a group of 


data items of the same type. For example, an array of int will hold 
the specified number of integers in consecutive memory locations. 
You specify an array by giving the type of data to be stored, the 
array name, and the number of items to be stored; put brackets 
around the number of items to be stored. 
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Arrays start at index 0 and 
end at a position one less 
than their assigned size. 


To try this one out, load and 
run INTRO26.C. 
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type name[size]; 


Here is how you might declare an array that will hold the total 
hours worked per week for an employee for one year: 


float hours[52]; 
This can be read as “hours, an array of 52 float values.” 


A particular item, called an element, of the array can be referred to 
by giving the array name followed by the position of the item, in 
brackets. The first item is stored at the address pointed to by the 
array name itself. This can also be referred to as position 0. Thus 
the total for the first week in the hours array can be referred to as 
hours[0]. The total for the tenth week would be hours[9], and the 
total for the 52nd week would be hours[51]. 


The following program initializes the array hours to 0, assigns 
values for the first four positions, and then prints the value out, 
showing how they are accessed: 


/* INTRO26.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 


{ 
float hours[52]; 
int week; 


/* Initialize the array */ 
for (week = 0; week < 52; week++) 
hours [week] = 0; 


/* Store four values in array */ 
hours[0] = 32.5; 


hours[1] = 44.0; 
hours[2] = 40.5; 
hours[3] = 38.0; 


/* Retrieve values and show their addresses */ 
printf ("Elements\t\tValue\tAddress\n") ; 
for (week = 0; week < 4; weekt+) 
printf ("hours [$d] \t\t%3.1f\t%p\n", week, hours[week], 
&hours [week] ); 


return 0; 


The output will look like this: 
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The addresses will vary from Pianent Wale. Bddress 
one time to the next, and hours {0} 30.5 PFOR 
from one machine to 
another hours [1] 44,0 FF12 
hours[2] 40.5 FF16 
hours [3] 38.0 FFIA 


Notice that the elements are stored in consecutive addresses, 4 
bytes apart (which is, after all, the size of a single float). The 
address operator & retrieves the address of the element 
referenced. The printf specifier %p (for pointer) displays the 
address as a hexadecimal number. The for statement is quite 
convenient for stepping through the elements of an array. 


You can also explicitly initialize an array at the time it is declared. 
To do so, place the values you want to assign between braces, 
separating them with commas. For example, 


int quarters[4] = {3, 10, 7, 14}; 


might hold the amount of points scored by a team in each quarter 
of a football game. (Of course data like this would probably come 
from being entered at the keyboard or being read from a file. But 
you can use explicit assignments to an array to provide data for 
testing your program.) 


When you assign character constants, put each character in single 
quotes: 


char ‘Grades(5|))=-{-4A%: 7B", 16h 0S, PY 


If you specify fewer values than the size of the array will accom- 
modate, and the array is global or static, Turbo C++ sets the 
remaining elements to 0 (if the array is of the numeric type) or to 
null characters (in the case of an array of characters). If you 
specify more values than specified in the size of the array, you will 
receive the error message, “Too many initializers.” 


Arrays can be more complex than this (for example, you can omit 
the array size, or initialize a character array with a string). How- 
ever, such topics are beyond the scope of this chapter. 


Arrays with 


Multiple Sometimes it is useful to have a set of sets of values—for example, 
dimensions if you want to store the total hours worked by 12 employees 
during 52 weeks, you can declare 


float hours[12] [52]; 
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Load and run GAME.C. 


Read this as “an array containing 12 arrays of 52 values each, of 


_ type float.” You can think of this layout as being like a spread- 


sheet with 12 columns and 52 rows. 


This next game generates a fictitious baseball score, by using an 
array called scoreboard[2][9] representing two teams and their 
respective scores for nine innings. 


/* GAME.C--Example from Chapter 4 of Getting Started */ 


#include <stdlib.h> 
#include <stdio.h> 
#include <conio.h> 


#define DODGERS 0 
#define GIANTS 1 


void main (void) 


int scoreboard [2] [9]; /* An array two rows by nine columns */ 
int team, inning; 
int score, total; 


randomize (); /* Initialize random number generator */ 


/* Generate the scores */ 
for (team = DODGERS; team <= GIANTS; teamtt) { 
for (inning = 0; inning < 9; inningt+t+) { 
score = random(3); 
if (score == 2) /* 1/3 chance to score at least a run */ 
score = random(3) + 1; /* 1 to 3 runs */ 
if (score == 3) 
score = random(7) + 1; /* Simulates chance of a big 
inning of 1 to 7 runs */ 
scoreboard[(team] [inning] = score; 


/* Print the scores */ 
printf("\nInning\tl 2 3 4 5 6 7 8 9 + fTotal\n"); 
printf ("Dodgers\t") ; 
total = 0; 
for (inning = 0; inning <= 8; inningt+) { 
score = scoreboard [DODGERS] [inning]; 
total += score; 
printf("td ", score); 
printf(" ‘%d", total); 


printf ("\nGiants\t") ; 
total = 0; 
for (inning = 0; inning < 9; inningt+) { 
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score = scoreboard[(GIANTS] [inning]; 
total += score; 
printf("sd ", score); 

} 

printf(" $d\n", total); 


Not surprisingly, when two array dimensions are involved, two 
nested for loops are often used to access the array elements. The 
inner loop, using inning as the counter variable, steps through the 
nine innings, while the outer switches from team 0 (Dodgers) to 
team 1 (Giants). 


Within the body of the loop, the random function (defined in the 
header file stdlib.h) generates the score. When random is first 
called as random(3), there is a 1/3 chance of score getting the value 
2. (random returns a value between 0 and one less than its 
parameter). If score has the value 2, it is recalculated as a random 
number between 1 and 3 runs. Finally, if score now is 3, a final 
random score of 1 to 7 runs is generated. The series of If state- 
ments thus attempts to simulate the occasional big inning. 


Two for loops then print out the scores, totaling them as they go. 
Each one prints out one team’s scores by using the team name as a 
constant value for the first dimension of the array, and varying 
the inning. Here’s a sample run: 


Inning 1 2 3 4 5 6 7 8 9 Total 
Dodgers 0 1 0 1 0 21 1 2 ~=«90 6 
Giants 1 1 0 2 0 0 4 1 = 0 9 


Arrays and strings 


Strings and arrays are very similar. In fact, a string is simply an 
array of char values with a null character stuck on the end. The 
following program declares a character array (string), then lets 
you store a value in it and extract a “substring” from the full 
string (load and run INTRO27.C): 


Remember that siting arrays /* INTRO27.C--Example from Chapter 4 of Getting Started */ 
need an extra element for 
the ending null character. #include <stdio.h> 
int main() 
{ 
char string[80]; /* Has 79 usable elements */ 


char number[10]; 
int pos, num chars; 
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printf("Enter a string for the character array: "); 
gets (string); 

printf("How many characters do you want to extract? "); 
gets (number) ; 

sscanf(number, “%d", &num chars); 


for (pos = 0; pos < num chars; pos+t) 
printf£("%c", string[pos]); 
printt("\n")3 


return 0; 


Here's a sample run: 


Enter a value for the character array: The quick brown fox 
How many characters do you want to extract? 9 
The quick 


wap It is usually more convenient to use the library routines that 
manipulate strings (such as streat or strtok) to deal with strings 
because they automatically take care of putting a null character at 
the end of the string. If you create a string with an array 
declaration and want to use these routines with it, you must 
supply the null character yourself. (The array must be large 
enough to hold the desired string plus the null character, which 
you must put at the end of the string.) 


Defining string 
variables You can define a variable of type char to hold a single character. 
Can you define a variable of type string to hold a string? No, 
because C does not treat strings as a separate data type. Remem- 
ber that a string is defined as a series of characters. One way to 
define a string variable is to declare an array of characters. Here’s 
an example of how this works. 


#include <stdio.h> 
#include <string.h> 


int main () 
char message[30]; 
strcpy(message, “This is the value of msg\n"); 
puts (message) ; 
return 0; 


The line char message[30] declares an array of characters (a string) 
that can hold up to 30 characters. You can only use 29 characters, 
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though, because there must also be room for the null character at 
the end. This chunk of 30 bytes has a starting address, which is 
stored in message. In the strepy call, the literal string 


This is the value of msg\n 


is first compiled and stored, and a null character is added at the 
end. 


When strepy runs, it copies the characters from this string, one at 
a time, into memory, starting at message's address. 


The Turbo C++ library has a variety of functions that do useful 
things with strings—you can read about them in Chapter 2, 
“Run-time library cross-reference,” in the Programmer's Guide. An 
example is streat, which combines (concatenates) strings: 


You can load and tun this /* INTRO28.C--Example from Chapter 4 of Getting Started */ 
code, INTRO28.C. 


#include <stdio.h> 
#include <string.h> 


int main() 

{ 
char name[60]; 
strcpy(name, “Bilbo "); 
strcat (name, “Baggins"); 
puts (name) ; 


return 0; 


Here, a character array is declared, large enough to hold all 
strings you want. The strepy function stores the first string, and 
then the streat function adds (concatenates) the last name onto 
the first. (Notice that the first value of name ended with a space, so 
the names would be separated.) 


Renaming types 


As you get into more complex data structures, it is helpful to be 
able to assign a meaningful name to them. You can do so using 
the typedef keyword. typedef gives a name to some combination 
of the standard C data types. Here are some examples: 


#include <stdio.h> 


int main() 
{ 
typedef unsigned char uchar; 
uchar greek alpha = 224, greek beta = 22); 
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printf("%c %c", greek alpha, greek beta); 
return 0; 


The typedef declaration gives the new name uchar to the type 
unsigned char. (This is a character type that can hold all 256 
characters of the extended PC character set). The second 
statement declares greek_alpha and greek_beta to be variables of 
type uchar, and the printf statement displays their values. 


typedef doesn’t actually create new data types. It just makes it 
easier to remember what kind of data you are dealing with later 
in your program. As you will see, it is particularly useful for 
giving names to more complex data types, such as enumerations 
and structures. 


Enumerated 


TyOes Data sometimes fits logically into an ordered series where one 
item follows another—for example, the days of the week. It is 
convenient to use a loop to step through such values. 


for (day = mon; day <= fri; dayt+t+) 
/* add hours worked that day to total for week */ 


Since a loop steps through numeric values, you need to give mon 
an integer value, tues the next integer, and so on. You could do 
this with #define statements: 


#define mon 0 
#define tues 1 
#define wed 2 
#define thurs 3 
#define fri 4 


However, the enum (enumerated) type offers a more compact 
way to do this, as shown in this example (load and run 
INTRO29.C): | 


/* INTRO29.C--Example from Chapter 4 of Getting Started */ 


finclude <stdio.h> 


int main() 
{ 
( 
enum workday {mon, tues, wed, thurs, fri}; 


int day; 


for (day = mon; day <= fri; dayt+t) 
printf("Sd\n", day); 
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return 0; 


The first declaration automatically assigns the value 0 to mon, 1 to 
tues, 2 to wed, and so on. These names can now be used to specify 
the starting value and limit for a for loop, as shown. 


Note that the numbers used in an enumeration don’t have to be 
consecutive—you can override the default order by assigning 
values as follows: 


enum scores {touchdown = 6, field goal = 3, safety = 2, point after = 1}; 
The statement 

printf("sd\n", touchdown + point after + field goal) 
displays the result 10. 


Combining data 


INto structures Arrays and enumerations give two powerful ways to handle sets 
of data values of the same type. A structure bundles together a set 
of data values of different types (or at least values that have 
different meanings). For example, information about an employee 
could be stored in the following structure: 


struct employee { 
char last name[30]; 
char first name[20]; 
char initial; 
double employee no; 
double SS no; 
Char dept code[3]; 
float annual salary; 


bi 


You have now defined a new data type employee and specified 
the list of data items (members) that a variable of employee type 
will have. As you can see, a variety of data types can be used—in 
this example, character arrays, single characters, doubles, and 
floats. 


Using parts of a 


structure The next example bundles together the information that the 
earlier program PLANETS.C needed to draw a planet. We’ll use it 
later to illustrate how parts of a structure can be initialized and 
accessed. Here they are displayed (load and run INTRO30.C): 
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A field of a structure is /* INTRO30,C--Example from Chapter 4 of Getting Started */ 


referred to by using the . . 
structure name followed by a #include <stdio.h> 
period and the member finclude <string.h> 


name. Thus mars.distance is 


the member containing the typedef struct { 


distance of Mars from the char name | 10]; 
Sun in astronomical units. float distance; 
float radius; 
} planet; 


planet mars; 


int main() 

{ 
strcpy(mars.name,"Mars") ; 
mars.distance = 1.5; 
mars.radius = 0.4; 


printf("Planetary statistics:\n"); 

printf("Name: %s\n", mars.name) ; 

printf("Distance from Sun in AU: %4.2f\n", mars.distance) ; 
printf("Radius in Earth radii: %4.2f\n", mars.radius); 


return 0; 


The typedef keyword gives the name planet to a struct (structure) 
consisting of three members, or fields: The planet name is an 
array of characters, while the distance and radius are floating- 
point values. The declaration struct planet mars creates a variable 
mars whose type is planet (in other words, it makes a copy of the 
structure defined earlier). In main, values are assigned to these 
three members. 


As shown here, the library function strepy is handy for copying a 
string value into structure fields that hold arrays of characters. 
The numeric values are simply assigned as usual. 


The printf statements at the end of the program use the 
name.member notation to reference and print out the values that 
were just assigned. 


— Building proper declarators 


A declarator is a statement in C that you use to declare functions, 
variables, pointers, and data types. And C allows you to build 
very complex declarators. This section gives you some examples 
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of declarators so that you can get some practice at designing (and 
reading) them; it’ll also show you some pitfalls to avoid. 


Traditional C programming has you build your complete 
declarator in place, nesting definitions as needed. Unfortunately, 
this can make for programs that are difficult to read (and write). 


Consider, for example, the declarators in the next table, assuming 
that you are compiling under the small memory model (small 
code, small data). 


Table 4.9: Declarators without typedefs 


i cem oa Function returning int 

int *pl; Pointer to int 

int *£2(); Function returning pointer to int 

int far *p2; Far pointer to int 

ING Tar Aes ()s Near function returning far pointer to int 

Int * far -£4(); Far function returning near pointer to int 

int (*fp1l) (int); Pointer to function returning int and accepting int parameter 

int (*f£p2) (int *ip); Pointer to function returning int and accepting pointer to int 

int. (far *fp3) (int far *ip) Far pointer to function returning int and accepting far pointer 
to int 

Int.«(tar *LiSt lS] )cint far * 1p}; Array of five far pointers to functions returning int and 


accepting far pointers to int 


int (far *gopher(int(far * fp[5})\ Near function accepting array of five far pointers to functions 
(ine far: *1p)) (int, tar-*ip); Returning int and accepting far pointers to int, and returning 
one such pointer (the backslash allows for line continuation) 


These are all valid declarators; they just get increasingly hard to 
understand. However, with judicious use of typedef, you can 
improve the legibility of these declarators. 


Here are the same declarators, rewritten with the help of typedef 
statements: 
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Table 4.10: Declarators with typedefs 


int fl(); Function returning int 
typedef int *intptr; 
IMtptr “pL? Pointer to int 
intptr: £2()? Function returning pointer to int 
typedef int far *farptr; 
farptr p2; Far pointer to int 
farpir 13(); Near function returning far pointer to int 
intptr far £4(); Far function returning near pointer to int 
typedef int (*fncptr1) (int); 
fncptrl fpl; Pointer to function returning int and accepting int parameter 
typedef int (*fncptr2) (intptr); 
fncptr2 fp2; Pointer to function returning int and accepting pointer to int 
typedef int (far *ffptr) (farptr); 
fiptr tp3; Far pointer to function returning int and accepting far pointer 
to int 
typedef ffptr ffplist [5]; 
ffplist list; Array of five far pointers to functions returning int and 
accepting far pointers to int 
ffptr gopher(ffplist); Near function accepting array of five far pointers to functions 
returning int and accepting far pointers to int, and returning 
one such pointer 
As you can see, there’s a big difference in legibility and clarity 
between this typedef declaration of gopher and the previous one. If 
you'll use typedef statements and function prototypes wisely, 
you'll find your programs easier to write, debug, and maintain. 
Pointers 
Every variable has a unique memory address that indicates the 
beginning of the memory area occupied by its value. The amount 
of memory used depends on the type of data involved. In the case 
of an int, this area is 2 bytes, while a float uses 4 bytes. For an 
array, the area occupied is equal to the number of elements times 
the size needed for one value of the declared data type. Fora 
structure, the area used is equal to the sum of the areas needed for 
the structure's members, plus some padding if needed and if you 
use the —a option. Because in all cases data is stored in an orderly, 
predictable way, it is possible to access data by manipulating a 
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Memory allocation is 
discussed further in Chapter 
4 of the Programmers Guide, 
“Memory modes, floating 
point, and overlays.“ 


Declaring and 
using a pointer 


Most programmers use 
names that include an 
abbreviation of the word 
pointer; for example, intptr. 


Load and run INTRO31.C. 


variable that contains the relevant address. Such a variable is 
called a pointer. 


Why are pointers useful? First, they allow you to access and ma- 
nipulate structured data easily, without having to move the data 
itself around in memory. For example, by being set to the addres- 
ses of consecutive elements in an array, a pointer can be used to 
initialize the array or to retrieve data from it. By adding to or 
subtracting from the pointer, you point to different data items. 


Pointers can also be used to allow a function to receive and 
change the value of a variable. This can avoid the need for de- 
claring global variables. 


Also, pointers are needed for allocating memory while your pro- 
gram is running: In essence, you ask for a chunk of free memory 
(via a function such as malloc), and get back a pointer to the first 
available address. 


A pointer declaration takes this form: 
type *name 


where type is any data type. Here are some example pointer 
declarations: 


int *intptr; /* Points to an integer */ 
float *fltptr; /* Points to a floating-point value */ 
char *string; /* Points to a character value */ 


You can declare a pointer to any object in memory, including 
arrays, structures, functions, and even other pointers. 


To access the value pointed to by a pointer, precede the pointer 
name with an asterisk. For example, *intptr yields the value stored 
at the address stored in the pointer intptr. Because this value is 
reached indirectly (rather than the case of a regular variable, 
where the value is stored at the variable’s own address), this pro- 
cess is called indirection or dereferencing. 


The following program declares a pointer and uses it to retrieve 
the value of a variable: 


/* INTRO31.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 


int main() 
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int intvar = 10; 

int. *intptr; 

intptr = gintvar; | 

printf("Location of intvar: %p\n", &intvar); 
printf("Contents of intvar: %d\n", intvar); 
printf("Location of intptr: $p\n", &intptr); 
printf("Contents of intptr: %p\n", intptr); 

printf("The value that intptr points to: $d\n", *intptr); 


return 0; 


Here’s the output: 


The values of the addresses Location of intvar: FFDC 
Si hal Contents of intvar: 10 

Location of intptr: FFDE 

Contents of intptr: FFDC 


The value that intptr points to: 10 


First, the int variable intvar is declared and assigned a value of 10. 
The next declaration declares an int * variable called intptr. (Read 
this declaration as “intptr, a pointer to an integer value.”) The 
next statement assigns intptr the address of the variable intvar 
(notice the &, or address-of operator). A pointer must always be 
assigned the address of the object it is intended to point to. If you 
neglect this, the pointer will contain a garbage address. If you try 
to store something at such an address by means of the pointer, 
you risk destroying part of your program or data, or even halting 
the system. 


As you can see from the output of the printf statements, intvar and 
intptr are stored at different addresses, since they are different 
variables. (Since they were declared consecutively, their addresses 
happen to be close together, but that has nothing to do with how 
pointers work.) As you can see, intptr contains the address of 
intvar (which had been assigned to it previously). The last printf 
statement prints the value pointed to by intptr; in other words, the 
contents of the address stored there. Since that address is that of 
intvar, the value pointed to is the contents of intvar. The next fig- 
ure may help you visualize all this. 
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Figure 4.8 


How pointers point (and 
what they point to) 


Pointers and 
strings 


This example is based on the 
earlier example of a string as 
a character array, but has 
been rewritten to use a 
pointer. To try it out, load and 
run INTRO32.C. 


Address Contents Code 


You've seen that you can access individual characters froma 
string by using indexing. For example, if you declare a string char 
name[20] and store the string “Madonna” in it, the value of 
name[2] is the character d (remembering that the count starts at 0: 
name[0] is M). An alternative way to handle strings is to declare a 
pointer to character and use it to manipulate the string. 


/* INTRO32.C--Example from Chapter 4 of Getting Started */ 
finclude <stdio.h> 


int main () 
{ 
char name[40]; 
char number[10]; 
char *str ptr = name; 
int pos, num chars; 


printf("Enter a string for the character array: "); 
gets (name) ; 

printf£("How many characters do you want to extract? "); 
gets (number) ; 

sscanf(number, "sd", &num chars); 


for (pos = 0; pos < num chars; pos+t} 
printf("tc", *str ptrtt); 
printf ("\n"); 


return 0; 
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Pointers, 
structures, and 
lists 


Notice that str_ptr is declared to be a pointer to character, and 
then assigned the address of the character array name. This could 
have been written in two separate statements: 


char *str ptr; 
strptr = name; 


but by now you know that C programmers seldom use two state- 
ments when one will do. Also notice that the address assigned is 
name, not &name. Referring to the name of an array (or structure) 
gets you the first address used to store the array’s values. This is 
equivalent to saying sname[0] (the address of the first element of 
the array name); you will sometimes see the latter notation. 


The rest of the program works in the same way as before, until 
you get to the for loop that extracts the requested substring. In the 
old version, the character being retrieved each time the loop exe- 
cutes was indexed from the array by using the expression 
namel[pos]. Here, however, the pointer is used, so the reference is 
to the value currently being pointed at: *str_ptr++. (The pointer is 
incremented each time so that it points to the next value.) 


Noncharacter arrays are handled with pointers in the same way 
as strings are. You increment the pointer to point to the next 
element in the array; you decrement it to point to the previous 
item. You have to check, of course, to make sure that you aren’t 
pointing to a location outside the bounds of the array. You 
usually do this by setting the appropriate limit for the loop 
statement used. 


It is important to remember that when the pointer ptr is incre- 
mented, it does not necessarily point to the next address—in fact, 
it usually doesn’t. The distance between addresses pointed to is 
equal to the size of the data type to which the pointer points. An 
int pointer points two addresses ahead when it’s incremented; a 
double pointer points eight addresses ahead. C handles this 
automatically. 


You may remember that you get the value of a member field of a 
structure by using the notation structure_name.member_name, so 
that the salary field in the employee structure named jim would 
be jim.salary. How do you access structures and parts of structures 


_ Turbo C++ Getting Started 


with a pointer? The following example shows how (load and run 
SOLAR.C): 


Figure 4.9 illustrates how this /* SOLAR.C--Example from Chapter 4 of Getting Started */ 
program works. 


#include <graphics.h> 
#include <stdio.h> 
#include <string.h> 


typedef struct { 
char name[10]; 
float distance; 
float radius; 
int: color: 
int fill type; 
} planet; 


planet solar system[9]; 
planet *planet ptr; 
int planet num; 


int main() 

{ 
strcpy(solar system[0].name, "Mercury") ; 
solar system[0].distance = 0.4; 
solar system[0].radius = 0.4; 
solar system[0].color = EGA YELLOW; 
solar system[0].fill type = EMPTY FILL; 


planet ptr = solar system; 


planet _ptrt++; /* Point to second planet structure */ 
oe strcpy (planet ptr->name, "Venus") ; 
The —> notation is explained planet ptr->distance = 0.7; 


on page 114. planet _ptr->radius = 1.0; 


planet ptr->color = EGA BROWN; 
planet ptr->fill type = SOLID FILL; 


planet ptr = solar system; /* Reset to first element */ 
for (planet num = 0; planet num < 2; planet numtt+, planet ptrt++) { 
printf("\nPlanetary statistics:\n"); 
printf("Name: @s\n", planet ptr->name) ; 
printf("Distance from Sun in AU: %4.2f\n", 
planet ptr->distance) ; 
printf("Radius in Earth radii: %4.2f\n", planet _ptr->radius); 
printf("Color constant value %d\n", planet ptr->color); 
printf ("Fill pattern constant value %d\n", 
planet _ptr->fill type); 


return 0; 
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Figure 4.9 
Using pointers fo access an 
array of structures 


Since planet_ptr was 
declared as a pointer to 
structure type planet, the 
built-in pointer arithmetic 
takes care of moving the 
pointed-to address enough 
bytes fo reach the next 
element of solar_system. 
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The following figure illustrates how the previous code might 
“look” during the first few steps through its for loop: 


Increment 43 
planet_pf,... = 
increment 
it again... 


E and again. 


planet solar_system[9] 
Array of nine planet structures 


The planet structure is an expanded version of the one shown 
earlier, with members added for the color and fill type. The next 
declarations 


planet solar system[9]; 
planet *planet ptr; 


specify an array, solar_system, whose nine members are copies of 
the planet structure and planet_ptr, a pointer to a planet structure. 


The first group of statements in main initialize the members of the 
first planet structure, using array and structure notation. To refer 
to a member of a structure in an array of structures, use the form 


array name[index] .member_name 


Thus the distance of the fourth planet in solar_system can be 
referred to as solar system[3] .distance. 


The second block of statements initialize a planet structure using 
pointers. Before you can use a pointer, you must assign it a valid 
address. The statement planet _ptr = solar system sets planet_ptr to 
point to the first element of the array solar_system. This is the 
element that has just been initialized, containing information for 
the planet Mercury. Therefore, the statement planet_ptr++ points 
to the next (second) element. 


With the pointer properly pointed, information about the second 
planet (Venus) is assigned to the second element of solar_system. 
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Using pointers to 
return values from 
functions 


Here, however, rather than array index notation, you see the use 
of the pointer planet_ptr to access the members of the planet 
structure. This takes the form 


pointer name->member_name 


so that, for example, the distance member for the planet structure 
currently being pointed to is planet_ptr->distance. 


The rest of the program displays the two planet structures that 
have been initialized. First, planet_ptr is set back to the first ele- 
ment by being assigned the address solar_system. The for loop 
increments planet_ptr and obtains the structure’s member values 
using the notation just discussed. Notice that the reference 
planet ptr->distance is a bit less cumbersome than 


solar _system[{index] .distance 
where index is the current element number. 


In fact, for any array, the index of an array is actually a pointer to 
the address of the array plus the index value, which internal 
pointer arithmetic converts to the array address plus 


index * sizeof (type) 


where type is the declared type of the array, and sizeof is a C 
operator that returns the number of bytes used by a type or 
variable. 


Pointers also allow you to change the actual value of the variable 
or variables used in calling a function. So far, functions have been 
called only with constant values or the names of variables. When 
you make a call such as draw(x cor, y cor, size, color), youare 
passing the values of the specified variables to the function draw. 
The function actually gets copies of these values and can refer to 
them by name and manipulate them, but this has no effect on the 
actual variables used by the caller. 


Sometimes it is useful to be able to call a function using variable 
names and have the function actually change the values of the 
variables themselves. This function is an example: 


void swap(int *a, int *b) 


swap swaps the values of the two variables with which the 
function is called. In order for the function to access the variables 
themselves, however, it must have not their values but their 


Chapter 4, An introduction to C 115 


addresses, so it can write the new values back to their location in 
memory. Therefore, the parameters are pointers to the appro- 
priate variables, not the variables themselves. Since a pointer 
refers to an address, you would call this function to swap the 
variables x and y using the statement swap (&x, &y). 


Here is the definition for the swap program, together with a main 
function that tests it doad and run INTRO33.C). 


/* INTRO33.C--Example from Chapter 4 of Getting Started */ 
#include <stdio.h> 
void swap(int *, int *); /* This is swap’s prototype */ 


int main() 
{ 
int x =5, y= 7; 
swap(&x, &y); 
printf("x is now Sd and y is now $d\n", x, y); 


return 0; 


void swap(int *a, int *b) /* swap is actually defined here */ 
{ 

int temp; 

temp = *a; 

ka = *b3 

*b = temp; 
} 


Notice that the swap function uses indirection (the * notation) to 
refer to the values contained in the variables x and y. The value of 
x is first stored in a temporary variable, then the value of y is 
stored in x. The former value of x is then obtained from the 
temporary variable and stored in y. 
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Figure 4.10 eet : 
Using pointers in a function Initialize variables: 


aes 
mos} NE 


Call the function: 
swap(&x, &y); 


Results: 


When you use pointers, a function is not limited to just returning 
one value via a return statement. A function can change the 
values of any variables it is given access to. While this could also 
be achieved (in this example) by making a and b global variables 
(declaring them outside of a function definition), it is easy to 
accidentally change a global variable. Pointers keep the trans- 
action private. 


Using system resources 


Thus far, the example programs have operated nearly in a 
vacuum. Some programs read data that you typed at the key- 
board, and every program displayed something on the screen. 
None of the data was stored in permanent form—if you want the 
data back, you must run the program again. In real applications, 
programs usually have to read in the bulk of their data from the 
disk drive, a communications port, or some other source. When 
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Using files and 
streams 


the data has been processed, the program may need to send it to 
the printer or write it to a disk file for later use. This is true of 
word processors, spreadsheets, and databases, for example. 


This section shows you how you can use Turbo C++ to read data 
from or write data to a disk file. Conceptually, Turbo C++ sets up 
something called a stream through which the data moves. There 
are lower-level ways to work with MS-DOS files, and library 
functions for dealing with them, but the stream features are 
recommended for portability. They allow you to use files without 
worrying about the target machine's operating system. 


A stream represents a file on the disk or some other device from 
which data can be read or to which it could be sent. (Many 
devices are used for input or output but not both—you can’t 
usually read data from a printer, and data sent to a keyboard 
won’t accomplish much.) In your program, you don’t manipulate 
the stream directly. Instead, the library defines a variable of the 
struct type FILE (which is defined in stdio.h). Since this structure 
manages a memory buffer for the file contents, you then declare a 
pointer to your FILE variable and use it to manipulate the file. 


To open a stream, you use a function (usually fopen) from the 
run-time library. You specify whether you want to read from the 
stream, write to the stream, or both. You also indicate whether 
you will treat the stream as text or binary data. 


Text streams are used for normal DOS files. The standard stream 
I/O assumes that text files consist of lines of text that each end 
with a single newline character (the ASCII linefeed character). 
DOS, however, stores files with both a carriage return and a new- 
line character following each line. When you declare a text stream, 
Turbo C++ translates CR/LF to a single linefeed on input, but 
translates the single linefeed to CR/LF when storing files on disk, 
maintaining compatibility with DOS. 


The basic steps involved in using a disk file with your Turbo C++ 
program are as follows 


1. Use #include <stdio.h> to include the necessary declarations 
for using files. 


2. Declare a pointer to the type FILE (defined in stdio.h). 
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3. Declare the data object(s) that will be used to receive infor- 
mation from the file. For example, a character array to hold a 
line of text, an array of some numeric type, or an array of 
structures. 


4. Open the file using fopen, including the file name and the type 
of access you will need (read only, writing, appending, and so 
on. See Chapter 2, “Run-time library cross-reference,” in the 
Programmer's Guide for more about file access functions). 

5. Make sure the file was opened by checking the value returned 
by fopen. 

6. Use the appropriate library function(s) to write or read the 
data. For text data, fprintf and fscanf work the same as their 
screen-oriented counterparts printf and sscanf. fputc and fgetc 
deal with single characters. For reading structured blocks of 
data of known size, fwrite and fread may be more suitable. 


7. When you’re done, close the file by using fclose. 
The following program opens a file, saves three lines of text in it, 
then reads them back out: 


Load and run INTRO34.C. /* INTRO34,C--Example from Chapter 4 of Getting Started */ 


#include <stdio.h> 
#include <stdlib.h> 


FILE *textfile; /* Pointer to file being used */ 
char line[81]; /* Char array to hold lines read from file */ 
int main () 


{ 

/* Open file, testing for success */ 

if ((textfile = fopen("intro34.txt", “w")) == NULL) { 
printf("Error opening text file for writing\n"); 
exit (0); 

} 

/* Write some text to the file */ 

fprintf(textfile, "$s\n", “one"); 

fprintf(textfile, "Ss\n", "two"); 

fprintf(textfile, "%s\n", “three"); 


/* Close the file */ 


fclose(textfile); 

/* Open file again */ 

if ((textfile = fopen("intro34.txt", "r")}) == NULL) { 
printf("Error opening text file for reading\n"); 
exit (0); 
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Opening a stream 


Table 4.11 
Preopened streams in Turbo 
C++ 


Writing to the file 


leading from the file 
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/* Read file contents */ 

while ((fscanf(textfile, "%s", line) != EOF)) 
printf£("Ss\n", line); 

/* Close file */ 

fclose(textfile); 


return 0; 


You have actually been using files all along. Every C program has 
automatic access to five streams, as shown in the next table. 


Name Function Connected to 
stdin Standard input Keyboard 
stdout Standard output Screen 

stderr Standard error Screen 
stdaux Standard auxiliary Serial port 
stdprn Standard print Printer port 


The first two default streams can be redirected in various ways. 


Due to their default connections, your Turbo C++ programs 
expect to get input from the keyboard and send their output to 
the screen. When you open a file with a pointer to the FILE type, 
you are opening an additional stream. 


In the example program, a pointer textfile to a stream is declared. 
The fopen statement associates this pointer with the disk file 
named text, which is opened with the access mode w (for write 
access). The if statement checks for the return value NULL, which 
is a predefined pointer indicating failure to open the file. 


fprintf writes the three lines of text to the file. fprintf works just 
like the familiar printf except that it gives the name of the stream 
pointer first, then the format specifier, and then the data to be 
written. Notice that a new line (\n) must be used to separate the 
lines of text so that they can be read later with fscanf. After the 
data is written, the file is closed with fclose. 


To read the text back from the file, the file is opened again with 
fopen, this time in read mode. fscanf reads each line into the 
character array line. A regular printf statement displays the line on 
the screen. The whole thing goes into a while loop that checks for 
fscanf to return the predefined value EOF (end of file). 
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This chapter covers the basic 
ideas of C++; Chapter 6, 
“Hands-on C++," fakes you 
on a rapid romp through 
several C++ program 
examples. 
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A C++ primer 


This chapter gives you the feel and flavor of the C++ language. 
We demystify some of the jargon and combine a little theory with 
simple, illustrative programs. The source code for these examples 
is provided on your distribution diskettes so you can study, edit, 
compile, and run them. (The graphics examples, of course, will 
run only if you have a graphics adapter and monitor. Any CGA, 
EGA, VGA, or Hercules setup will do.) 


Turbo C++ provides all the features of AT&T’s C++ version 2.0. 
C++ is an extension of the popular C language, adding special 
features for object-oriented programming (OOP). 


OOP is a method of programming that seeks to mimic the way we 
form models of the world. To cope with the complexities of life, 
we have evolved a wonderful capacity to generalize, classify, and 
generate abstractions. Almost every noun in our vocabulary re- 
presents a class of objects sharing some set of attributes or beha- 
vioral traits. From a world full of individual dogs, we distill an 
abstract class called dog. This allows us to develop and process 
ideas about canines without being distracted by the details con- 
cerning any particular dog. The OOP extensions in C++ exploit 
this natural tendency we have to classify and abstract things—in 
fact, C++ was originally called “C with Classes.” 


Three main properties characterize an OOP language: 


= Encapsulation: Combining a data structure with the functions 
(actions or methods) dedicated to manivulating the data. 
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Encapsulation is achieved by means of a new structuring and 
data-typing mechanism—the class. 


w Inheritance: Building new, derived classes that inherit the data 
and functions from one or more previously-defined base classes, 
while possibly redefining or adding new data and actions. This 
creates a hierarchy of classes. 


u Polymorphism: Giving an action one name or symbol that is 
shared up and down a class hierarchy, with each class in the 
hierarchy implementing the action in a way appropriate to 
itself. 


Borland’s C++ gives you the full power of object-oriented pro- 
gramming: 


™ more control over your program’s structure and modularity 


= the ability to create new data types with their own specialized 
operators 


wand the tools to help you create reusable code 


All these features add up to code that can be more structured, 
extensible, and easier to maintain than that produced with non- 
object-oriented languages. 


To achieve these important benefits of C++, you may need to 
modify ways of thinking about programming that have been 
considered standard for many years. Once you do that, however, 
C++ is a simple, straightforward, and superior tool for solving 
many of the problems that plague traditional software. 


Your background may affect the way you look at C++: | 


If you are new to C and C++. You may at first have some difficulty 
with the new concepts discussed in this chapter, but working 
through (and experimenting with) the examples will help make 
the ideas concrete. Before you begin, you should make sure you 
understand the basic elements of the C language (you may wish 
to review Chapter 4 before continuing here). As a beginner, you 
have one very real advantage: You probably have fewer old pro- 
gramming habits to unlearn. 


it you are an experienced C programmer. C++ builds upon the 
existing syntax and capabilities of C. This makes the learning 
curve much gentler than if you had to learn a whole new lan- 
guage. It also allows you to port existing C programs to C++ with 
a minimum of recoding. You aren’t losing C’s power and effi- 
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Encapsulation 


ciency: You’re adding the representational power of classes and 
the security of controlling access to internal data. 


If you program in Turbo Pascal 5.5. Turbo Pascal 5.5 embodies 
many of the same object-oriented features found in C++. While 
you will have to deal with basic syntax differences between the 
two languages, you will find that Turbo Pascal 5.5 objects and 
Turbo C++ classes are structured similarly. You will recognize 
C++ member functions as being like Turbo Pascal 5.5’s methods, and 
may note many other similarities. The main difference you will 
observe is that C++ has tighter control over data access. 


If you are experienced in another object-oriented programming 
language. You will find some differences in C++: 


m First, the syntax of C++ is that of a traditional, procedural 
language. 

m Second, the way C++ and Smalltalk actually deal with objects 
during compilation is different. Smalltalk’s binding is done 
completely at run time (late binding); C++ allows both compile- 
time (early) binding and late binding. 


In this chapter, we begin by describing the three key OOP ideas— 
encapsulation, inheritance, and polymorphism—in more detail. 
The first listings show fragments of code to illustrate each topic. 
Later, we present complete, compilable programs. The main ex- 
ample develops object-oriented representations useful for 
graphics, but occasional side tours show how C++ works with 
strings and other data structures. 
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How does C++ change the way you work with code and data? 
One important way is encapsulation: the welding of code and data 
together into a single class-type object. For example, you might 
have developed a data structure, such as an array holding the 
information needed to draw a character font on the screen, and 
code (functions) for displaying, scaling and rotating, highlighting, 
and coloring your font characters. 


In traditional C, the usual solution is to put the data structures 
and related functions into a single separately compiled source file 
in an attempt to treat code and data as a single module. While this 
is a step in the right direction, it isn’t good enough. There is no ex- 
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In these manuals, we use 


bold type to distinguish the 
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keyword class from the 
generic word “class.” 


Warning! 


plicit relationship between the data and the code, and you or 
another programmer can still access the data directly without 
using the functions provided. This can lead to problems. For ex- 
ample, suppose that you decide to replace the array of font 
information with a linked list? Another programmer working on 
the same project may decide that she has a better way to access 
the character data, so she writes some functions of her own that 
manipulate the array directly. The problem is that the array isn’t 
there any more! 


C++ comes to the rescue by extending the power of C’s struct and 
union keywords, and by adding a keyword not found in C: class. 
All three keywords are used in C++ to define classes. 


In C++, a single class entity (defined with struct, union, or class) 
combines functions (known as member functions) and data (known 
as data members). You usually give a class a useful name, such as 
Font. This name becomes a new type identifier that you can use to 
declare instances or objects of that class type: 


class Font { 
// here you declare your members: both data and functions; 
// don't worry how for the moment. 
hi 
Font Tiffany; // declares Tiffany to be of type class 
// Font. 


Note that in Turbo C++ you can now use two slashes (//) to 
introduce a single-line comment in both C and C++. You can still 
use the /* */ comment characters if you prefer them; in fact, they 
are especially useful for long comments. 


Use of the // comments is not usually portable to other C 
compilers. However, it is portable to other C++ compilers. 


The variable Tiffany is an instance (sometimes called an 
instantiation) of the class Font. You can use the class name Font 
very much like a normal C data type. For example, you can 
declare arrays and pointers: 


Font Times[10]; // declare an array of 10 Fonts 
Font* font ptr; // declare a pointer to Font 


A major difference between C++ classes and C structures 
concerns the accessibility of members. The members of a C 
structure are freely available to any expression or function within 
their scope. With C++, you can control access to struct and class 
members (code and data) by declaring individual members as 
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C++ structs and unions are 
not quite the same as the C 
versions. 
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public, private, or protected. (A C++ union is more like a C union, 
with all members public.) We'll explain these three access levels in 
more detail later on. 


C++ structures and unions offer more than their C counterparts: 
they can hold function declarations and definitions as well as data 
members. In C++, the keywords struct, union, and class can all 
be used to define classes. 


m A class defined with struct is simply a class in which all the 
members are public by default (but you can vary this 
arrangement if you wish). 

A class defined with union has all its members public (this 
access level cannot be changed). 


m Ina class defined with class, the members are private by 
default (but there are ways of changing their access levels). 


So, when we talk about classes in C++, we include structures and 
unions, as well as types defined with the keyword class. 


Typically, you restrict member-data access to member functions: 
you usually make the member data private and the member 
functions public. 


Returning to the problem of handling fonts, how does the C++ 
class concept help? 


By creating a suitable Font class, you can ensure that the private 
font data can be accessed and manipulated only through the 
public Font member functions that you have created for that 
purpose. You are now free at any time to change the font data 
structure from an array to a linked list, or whatever. You would, 
of course, need to recode the member functions to handle the new 
font data structure, but if the function names and arguments are 
unchanged, programs (and programmers) in other parts of your 
system will be unaffected by your improvements! 


The next figure compares the ways C and C++ provide access to a 
font. 
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Figure 5.1] 
Traditiona! C versus 
encapsulated C++ 


Inheritance 


A C STRUCTURE A C++ CLASS 
AND CODE 


| ra data 


/* Code that does something */ 
/* with the data: / 


/* Member functions */ 
© constructor(...) 
© get(...) 
© sort(...) 
@ print(...) 
} 


Thus the technique of encapsulation in classes helps provide the 
very real benefit of modularity, as found in languages such as Ada 
and Modula-2. The C++ class establishes a well-defined interface 
that helps you design, implement, maintain, and reuse programs. 
Debugging a C++ program is often simpler since many errors can 
be quickly traced to one particular class. 


The class concept leads to the idea of data abstraction. Our font 
data structure is no longer tied to any particular physical imple- 
mentation; rather, it is defined in terms of the operations (member 
functions) allowed on it. At the same time, the traditional C 
philosophy that views a program as a collection of functions, with 
data as second-class citizens, has also shifted. The C++ class weds 
data and function as equal, interdependent partners. 
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The descriptive branches of science (required before the 
explanatory and predictive aims of science can bear fruit) spend 


_ much time classifying objects according to certain traits. It often 


helps to organize your classification as a family tree with a single 
overall category at the root, with subcategories branching out into 
subsubcategories, and so on. 
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Figure 5.2 
A partial taxonomy chart of 
Insects 
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Entomologists, for example, classify insects as shown in Figure 
5.2. Within the phylum insect there are two divisions: winged and 
wingless. Under winged insects is a larger number of categories: 
moths, butterflies, flies, and so on. 


butterflies 


This classification process is called taxonomy. It’s a good starting 
metaphor for OOP’s inheritance mechanism. 


The questions we ask in trying to classify some new animal or 
object are these: How is it similar to the others of its general class? 
How is it different? Each different class has a set of behaviors and 
characteristics that define it. We begin at the top of a specimen’s 
family tree and start descending the branches, asking those 
questions along the way. The highest levels are the most general, 
and the questions the simplest: Wings or no wings? Each level is 
more specific than the one before it, and less general. 


Once a characteristic is defined, all the categories beneath that defi- 
nition include that characteristic. So once you identify an insect as 
a member of the order diptera (flies), you needn’t make the point 
that a fly has one pair of wings. The species fly inherits that 
characteristic from its order. 


OOP is the process of building class hierarchies. One of the im- 
portant things C++ adds to C is a mechanism by which class types 
can inherit characteristics from simpler, more general types. This 
mechanism is called inheritance. Inheritance provides for common- 
alty of function while allowing as much specialization as needed. 
Ifa class D inherits from class B, we say that D is the derived class 
and B is the base class. 
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It is by no means a trivial task, though, to establish the ideal class 
hierarchy for a particular application. The insect taxonomy took 
hundreds of years to develop, and is still subject to change and 
acrimonious debate. Before you write a line of C++ code, you 
must think hard about which classes are needed at which level. 
As the application develops, you may find that new classes are 
required that fundamentally alter the whole class hierarchy. The 
bibliography lists many books on this subject. Remember also that 
a growing number of vendors are supplying Turbo C++ 
compatible libraries of classes. So don’t reinvent too many wheels. 


Occasionally, you encounter a class that combines the properties 
of more than one previously established class. C++ version 2.0 
offers a mechanism (not found in earlier C++ versions) known as 
multiple inheritance whereby a derived class can inherit from two 
or more base classes. You'll see later how this is achieved as a 
logical extension of the single inheritance mechanism. 


Polymorphism 


The word polymorphism comes from the Greek: “having many 
shapes.” Polymorphism in C++ is accomplished with virtual func- 
tions. Virtual functions let you use many versions of the same 
function throughout a class hierarchy, with the particular version 
to be executed being determined at run time (this is called late 
binding). 


Overloading 


In C, you can only have one function with a given name. For 
example, if you declare and define the function 


int cube (int number); 


you can now get the cube of an integer. But suppose you want to 
cube a float or a double? You can of course declare functions for 
these purposes, but they can’t use the name cube: 


float fcube (float float number) ; 
double dcube (double double number); 
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In C++, however, you can overload functions. This means that you 
can have several functions that have the same name but work 
with different types of data. Thus you can declare: 


int cube (int number); 
float cube (float float number); 
double cube (double double number); 


As long as the argument lists are all different, C++ takes care of 
calling the correct function for the argument given. If you have 
the call cube(10); the int version of cube is called, while if you call 
cube(2.5); the double version will be called. If you call cube(2.5F), 
then you are passing a floating-point literal rather than a double, 
and the float version will be called. Even operators such as + can 
be overloaded and redefined so they work not only with 
numbers, but with graphic objects, strings, or whatever is 
appropriate for a given class. 


Modeling the real world with classes 


Building classes: a 
graphics example 
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The C++ class provides a natural way of building computer 
models of real-world systems—indeed, Bjarne Stroustrup devised 
the language at AT&T Bell Labs in order to model a large 
telephone switching system. 


There have been many C++ applications in the motor industry. 
When modeling vehicles, for instance, you would be interested in 
both the physical description (the number of tires, engine power, 
weight, and so on) and the behavior (acceleration, breaking, 
steering, fuel consumption). A Car class could encapsulate the 
physical parameters (data) and their behavior (functions) in a 
very general way. Using inheritance, you might then derive 
specialized Sports_car and Station_wagon classes, adding new 
data types and functions, as well as modifying (overriding) some 
of the functions of the base class. Much of the coding you have 
done for the base class(es) is reused or at least recycled. 


In a graphics environment, a reasonable place to start would be a 
class that models the physical pixels on a screen with the abstract 
points of plane geometry. A first try might be a struct class called 
Point that brings together the X and Y coordinates as data 
members: 
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When you define a class, you 
add a new daia type fo 
C++. The language treats 
your new data type in the 
same way that it treats built- 
in data types. 


The terms object and class 
instance are used 
interchangeably in C++. 


The Boolean type will be 
familiar to Turbo Pascal pro- 
grammers. 
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struct Point { // defines a struct class called Point 
int X; // struct member data are public by default 
int Y; 

b; 


You can now declare several particular variables of type struct 
Point (for brevity, we often loosely refer to such variables as being 
of type Point). In C, you would use declarations such as 


struct Point Origin, Center, Cur Pos, AnyPoint; 
but in C++, all you need is 
Point Origin, Center, Cur Pos, AnyPoint; 


A variable of type Point (such as Origin) is one of many possible 
instances of type Point. Note carefully that you assign values (par- 
ticular coordinates) to instances of the class Point, not to Point 
itself. Beginners often confuse the data type Point with the 
instance variables of type Point. You can write Center = Origin 
(assign Origin’s coordinates to Center), but Point = Origin is 
meaningless. 


When you need to think of the X and Y coordinates separately, 
you can think of them as independent members (fields) X and Y 
of the structure. On the other hand, when you need to think of the 
X and Y coordinates working together to fix a place on the screen, 
you can think of them collectively as Point. 


Suppose you want to display a point of light at a position de- 
scribed on the screen. In addition to the X and Y location mem- 
bers you have already seen, you'll want to add a member that 
specifies whether there is an illuminated pixel at that location. 
Here's a new struct type that includes all three members: 


enum Boolean (false, true}; // false = 0; true = 1 


struct Point { 
int X; 
int Y; 
Boolean Visible; 


}} 


This code uses an enumerated type (enum) to create a true/false 
test. Since the values of enumerated types start at 0, Boolean can 
have one of two values: 0 or 1 (false or true). 
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Declaring objects 


Member 
functions 


Data members are what the 
class knows; its member 
functions are what the class 
does. 


Inline functions are discussed 
in more detail on pages 139 
and 175. 
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As with other data types, you can have pointers to classes and 
arrays of classes: 


Point Origin; // declare object Origin of type Point 

Point Row[80]; // declare an array of 80 objects of type Point 
Point *point ptr; // declare a ‘pointer to type Point’ 

point ptr = &Origin; // point it to the object Origin 

point ptr = Row; // then point it to Row[0] 


As you saw earlier, C++ classes can contain functions as well as 
data members. A member function is a function declared within the 
class definition and tightly bonded to that class type. (Member 
functions are known as methods in other object-oriented lan- 
guages, such as Turbo Pascal and Smalltalk.) 


Let’s add a simple member function, GetX, to the class Point. 
There are two ways of adding a member function to a class: 


m Define the function inside the class 
= Declare it inside the class, then define it outside the class 


The two methods have different syntaxes and technical 
implications. 


The first method looks like this: 


struct Point { 


Tne VF 
Boolean Visible; 
int GetX() { return X;} // inline member function defined 
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This form of definition makes GetX an inline function by default. 
Briefly, inline functions are functions “small” enough to be use- 
fully compiled in situ, rather like a macro, avoiding the overhead 
of normal function calls. 


Note that the inline member function definition follows the usual 
C syntax for a function definition: the function GetX returns an int 
and takes no arguments. The body of the function, between { and 
}, contains the statements defining the function—in our case, the 
single statement, return X;. 
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The :: is known as the scope 
resolution operator, it tells the 
compiler where the function 


Chapter I, “The Turbo C++ 
language standard,” in the 
Programmers Guide explains 


belongs. 


class scope in more detail. 


Calling a member 
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function 


In the second method, you simply declare the member function 
within struct Point, (using normal C function declaration syntax), 
then provide its full definition (complete with the body statements) 
elsewhere, outside the body of the class definition. 


struct Point { 


int Xe 
Boolean Visible; 
int GetX(); // member function declared 
bi 
int Point::Getx() { // member function defined 
return X; // outside the class 


Member functions defined outside the class definition still can be 
made inline (if certain conditions are met), but you have to re- 
quest this explicitly with the keyword inline. 


Note carefully the use of the scope resolution operator in 
Point::GetX in the function definition. The class name Point is 
needed to tell the compiler which class GetX belongs to (there 
may be other versions of GetX around belonging to other classes). 
The inside definition did not need the Point:: modifier, of course, 
since that GetX clearly belongs to Point. 


The Point:: in front of GetX also serves another purpose. Its 
influence extends into the function definition, so that the X in 
return X; is taken as a reference to the X member of the class 
Point. Note also that the body of Point::GetX is within the scope 
of Point regardless of its physical location. 


Whichever defining method we use, the important point is that 
we now have a member function GetX tied to the class Point. 
Since it is a member function, it can access all the data variables 
that belong to Point. In our simple case, GetX just accesses X, and 
returns its value. 


Now member functions represent operations on objects of their 
class, so when we call GetX we must somehow indicate which 
Point object is being operated on. If GetX were a normal C func- 
tion (or a C++ nonmember function), this problem would not 
arise—you would simply invoke the function with the expression, 
GetX(). With member functions, you must supply the name of the 
target object. The syntax used is a natural extension of that used 
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Constructors and 
destructors 
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in C to reference structure members. Just as you would refer to 
Origin.X for the X component of the object Origin, or to Endpoint.Y 
for the Y component of the object Endpoint, you can invoke GetX 
with Origin.GetX() or Endpoint.GetX(). The “.” operator serves as 
the class component selector for both data and function members. 
The general calling syntax is 


class-object-name.member-function-name(argument-list) 


In the same way, if you had a pointer to a Point object, you would 
use the pointer member selector, “->”: Point _pointer->Getx(). 
You'll see many examples of such member function calls in the 
examples in this chapter. 


There are two special types of member functions, constructors and 
destructors, that play a key role in C++. To appreciate their impor- 
tance, a short detour is needed. A common problem with 
traditional languages is initialization: Before using a data structure, 
it must be allocated memory and initialized. Consider the task of 
initializing the structure defined earlier: 


struct Point { 
int X; 
t..13 
Boolean Visible; 
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Inexperienced programmers might try to assign initial values to 
the X, Y, and Visible members in the following way: 


Point ThisPoint; 
ThisPoint.X = 17; 
ThisPoint.Y = 42; 
ThisPoint.Visible = false; 


This works, but it’s tightly bound to one specific object, ThisPoint. 
If more than one Point object needs to be initialized, you'll need 
more assignment statements that do essentially the same thing. 
The natural next step is to build an initialization function that 
generalizes the assignment statements to handle any Point object 
passed as an argument: 


void InitPoint (Point *Target, Int NewX, Int NewY) 


{ 
Target->X = Newx; 
Target->Y = NewY; 
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Target->Visible = false; 
} 


This function takes a pointer to a Point object and uses it to assign 
the given values to its members (note again the —> operator when 
using pointers to refer to class members). You've correctly de- 
signed the function InitPoint specifically to serve the structure 
Point. Why, then, must you keep specifying the class type and the 
particular object that InitPoint acts upon? The answer is that 
InitPoint is not a member function. What we really need for true 
object-oriented bliss is a member function that will initialize any 
Point object. This is one of the roles of the constructor. 


C++ aims to make user-defined data types as integral to the lan- 
guage (and as easy to use) as built-in types. Therefore, C++ pro- 
vides a special type of member function called a constructor. A 
constructor specifies how a new object of a class type will be 
created, ie., allocated memory and initialized. Its definition can 
include code for memory allocation, assignment of values to 
members, conversion from one type to another, and anything else 
that might be useful. Constructors can be user-defined, or C++ 
can generate default constructors. Constructors can either be 
called explicitly or implicitly. The C++ compiler automatically 
calls the appropriate constructor whenever you define a new 
object of the class. This can happen in a data declaration, when 
copying an object, or through the dynamic allocation of a new 
object using the operator new. 


Destructors, as the name indicates, destroy the class objects previ- 
ously created by a constructor by clearing values and deallocating 
memory. As with constructors, destructors can be called explicitly 
(using the C++ operator delete) or implicitly (when an object goes 
out of scope, for example). If you don’t define a destructor for a 
given class, C++ generates a default version for you. Later on, 
we'll be looking at the syntax for defining destructors. First, 
though, let’s see how constructors are made. 


The following version of Point adds a constructor: 


struct Point { 
int X; 
Rohome & 
Boolean Visible; 
int GetX() {return X;} 
Point (int NewX, int NewY); // constructor declaration 
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Point::Point indicates that we 
are defining a constructor for 
the class Point. 
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Point::Point(int NewX, int NewY) // constructor definition 


X = Newx; 

Y = NewY; 

Visible = false; 
es 


The constructor definition here is made outside the class definition. 
Constructors can also be legally defined inside the class, as inline 
functions. Or they can be defined outside the class definition and 
made inline with the keyword inline. However, some care is 
needed: the amount of code generated by a constructor is not 
always proportional to the visible source code in its definition. 


Notice that the name of a constructor is the same as the name of 
the class: Point. That’s how the compiler knows that it is dealing 
with a constructor. Also note that a constructor can have argu- 
ments as with any other kind of function. Here the arguments are 
NewX and NewY. The constructor body is built just like the body 
of any member function, so a constructor can call any member 
functions of its class or access any member data. A constructor, 
though, never has a return type—not even void. 


Now you can declare a new Point object like this: 
Point Origin(1,1); 


This declaration invokes the previously defined Point constructor 
for you. As you'll see later, you can have more that one 
constructor for a class—and, as with other C++ overloaded func- 
tions, the appropriate version will be automatically invoked 
according to the argument lists involved. You'll also see that if 
you do not define a constructor, C++ generates a default 
constructor with no arguments. 


Another useful trick in C++ is that you can have default values for 
function arguments: 


Point: :Point(int NewX=0, int NewY=0) // revised constructor 
definition 
{ 


// as before 


} 
The declaration, 
Point Origin(5); 
would initialize X to 5 and Y to 0 by default. 
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Code and data 


together One of the most important tenets of object-oriented programming 
is that the programmer should think of code and data together 
during program design. Neither code nor data exist in a vacuum. 
Data directs the flow of code, and code manipulates the shape and 
values of data. 


When your data and code are separate entities, there’s always the 
danger of calling the right function with the wrong data or the 
wrong function with the right data. Matching the two is the pro- 
grammer’s job, and while ANSI C, unlike traditional C, provides 
good type-checking, at best it can only say what doesn’t go 
together. 


By bundling code and data declarations together, C++ classes help 
keep them in sync. Typically, to get the value of one of a class's 
data members, you call a member function belonging to that class 
which returns the value of the desired member. To set the value of 
a field, you call a member function that assigns a new value to 
that field. 


Member access 


control: private, While the enhanced struct in C++ allows bundling of data and 
public, and functions, it is not as encapsulated or modular as it could be. As 
we mentioned earlier, access to all data members and member 
protected functions of a struct is public by default—that is, any statement 
within the same scope can read or change the internal data of a 
struct class. As noted earlier, this isn’t desirable and can lead to 
serious problems. Good C++ design practices data hiding or infor- 
mation hiding—keeping member data private or protected, and 
providing an authorized interface for accessing it. The general 
rule is to make all data private so that it can be accessed only 
through public member functions. There are only a few situations 
where public rather than private or protected data members are 
needed. Also, some member functions involved only in internal 
operations can be made private or protected rather than public. 


Three keywords provide access control to structure or class mem- 
bers. The appropriate keyword (with a colon) is placed before the 
member declarations to be affected: 
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Tne class: private 
by default 
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private: Members following this keyword can be accessed 
only by member functions declared within the same 
class. 

protected: Members following this keyword can be accessed by 
member functions within the same class, and by 
member functions of classes that are derived from 
this class (see the discussion on page 141). 

public: Members following this keyword can be accessed 
from anywhere within the same scope as the class 
definition. 


For example, here is how to redefine the Point structure so that 
the data members are private and the member functions are 
public: 


struct Point { 
private: 
int xX; 
int: Y? 
public: 
int GetX(); 
Point (int NewX, int NewY); 
h} 


A struct class is public by default, so you have to use private: to 
specify the private part, and then public: for the part to be made 
available for general access. Since good C++ practice makes things 
private by default and carefully specifies what should be public, 
C++ programmers generally favor the class over the struct. The 
only difference between a class and a struct is this matter of 
default privacy. 


Point redefined as a class looks like this: 


class Point { 


int: xX; // private by default 
int: 4? 

public: // needed to override the private default 
int GetX(); 


Polnt (int NewX, int NewY); 
hi 


No private modifier is needed for the data members—they’re 
private by default. The member functions, however, must be de- 
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clared public so that they can be used outside of the class to 
initialize and retrieve values of Point objects. 


You can repeat access control specifications as often as needed: 


enum Boolean {false, true}; 


class Employee { 
double salary; // private by default 
Boolean permanent; 
Boolean professional; 


public: 
char name[30]; 
char dept _code[3]; 


private: 
int Error check (void) ; 


public: 
Employee (double salary, Boolean permanent, Boolean professional, 
char *name, char *dept code); 


\; 


Data members are usually Here the data members salary, permanent, and professional are 


private, while member func- 
tions are usually public. Allow 
public access only where it is 
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truly needed. 


Running a C++ 
program 


private by default; the data members name and dept_code are de- 
clared to be public; the member function Error_check is declared 
to be private (intended for internal use); and the constructor 
Employee is declared to be public. 


It’s time to put everything you've learned so far together into a 
complete compilable program. To compile a C++ program in the 
integrated environment, enter or load your text into the editor as 
usual. You can run C++ programs from the IDE in either of two 
ways. First, by default, any file with the .CPP extension will be 
compiled assuming C++ syntax, and any files with the .C exten- 
sion will be compiled assuming C syntax. However, you can 
select the C++ Always button in the Source Options dialog box to 
have all files treated as C++ source files, regardless of extension. 


To compile a C++ program with the command-line compiler, just 
give your file the extension .CPP. Or you can use the command- 
line option —P, in which case Turbo C++ will assume that the file 
has an extension of .CPP. If the file has a different extension, you 
must give the extension along with the file name. Life will be 
easier for you (and your next-of-kin) if you give all C++ programs 
a .CPP extension and all C programs a .C extension. 


Turbo C++ Getting Started 


The program POINT.CPP defines the Point class and manipulates 
its data values: 


This code Is available to load x x 
and run: POINT. CPP. /* POINT.CPP illustrates a simple Point class */ 
#include <iostream.h> // needed for C++ 1/0 
class Point { // define Point class 
int X; // X and Y are private by default 
int: Ye 
publics 


Point (int InitX, int InitY) {X = InitX; Y = Inity;} 
int GetX() {return X;} // public member functions 
int GetY() {return Y;} 

}} 

int main() 


int YourxX, Youry; 


cout << "Set X coordinate: "; // screen prompt 
cin >> YourX; // keyboard input to YourX 


cout << "Set Y coordinate: "; // another prompt 
cin >> YourY; // key value for YourY 


Point YourPoint (YourX, YourY); // declaration calls constructor 


cout << "X is " << YourPoint.GetX(); // call member function 
cout << ‘\n!'; // newline 

cout << "Y is " << YourPoint.GetY(}; // call member function 
cout. << '\n' > 

return 0; 


The class Point now contains a new member functions, GetY. This 
function works just like the GetX defined earlier, but accesses the 
private data member Y rather than X. Both are “short” functions 
and good candidates for the inline form of definition within the 
class body. 


As with a macro using the #define directive, the code for an inline 
function is substituted directly into your file each time the func- 
tion is used, thereby avoiding the function call overhead at the 
expense of code size. This is the classic “space versus time” 
dilemma found in many programming situations. As a general 
rule you should only use inline definitions for “short” functions, 
say one to three statements. Note that, unlike a macro, an inline 
function doesn’t sacrifice the type checking that helps prevent 
errors in function calls. The number of arguments in a function is 
also relevant to your decision whether to “inline” or not, since the 
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The iostreams library is 


discussed in detail on page 
184 and also in Chapter 3, 
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“C++ streams,” in the Pro- 
grammer’ Guide. 


argument structure affects the function call overhead. The case for 
inlining is strongest when the total code for the function body is 
smaller than the code it takes to call the function out of line. You 
may need to try both methods and examine the assembly code 
output before deciding which approach is best for your needs. 


Whether to inline a constructor or not can depend on whether 
base constructors are involved. A derived class constructor, 
especially where there are virtual functions (see page 156) in the 
hierarchy, can generate a lot of “hidden” code. 


In the above example, the Point constructor has been defined as 
out-of-line, following the end of the class declaration. While you 
can put definitions in any order (and even put them elsewhere in 
the current file), it makes sense with smaller, single-file programs 
to put those definitions that aren’t inline right after the class 
definition, in the order in which they were declared. 


As your code gets larger, you’ll probably have your class declara- 
tions in header files, and your class function definitions 
(implementation code) in separately compiled C++ source files. 
Inline function definitions, however, should always be in the 
header file. 


This program also introduces the C++ iostreams library (note the 
statement #include <iostream.h> at the beginning of the program). 


cout represents the standard output stream (by default, the screen). 
Data (variable values and strings, for example) are sent to it using 
the “put to” or insertion operator, <<. 


cin represents the standard input stream (normally the keyboard). 
Values typed at the keyboard are stored in variables using the >> 
(“get from” or extraction) operator. The use of the shift operators, 
>> and «<<, for stream I/O is a typical example of operator 
overloading in C++. 


The streams functions save you having to deal directly with the 
kinds of formatting details that printf and scanf require; they also 
allow I/O to be tailored to particular classes. 


Once the X and Y values have been received from the keyboard, 
the Point object YourPoint is declared with the received values as 
arguments. Recall that this declaration automatically invokes the 
constructor for the Point class, which creates and initializes 
YourPoint. 


Try running the program. The result should look like this: 
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Inheritance 


Set X coordinate: 50 
Set Y coordinate: 100 
X is 50 
Y is 100 


Rethinking the 
Point class 
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Classes don’t usually exist in a vacuum. A program often has to 
work with several different but related data structures. For exam- 
ple, you might have a simple memory buffer in which you can 
store and from which you can retrieve data. Later, you may need 
to create more specialized buffers: A file buffer that holds data 
being moved to and froma file, and perhaps a buffer to hold data 
for a printer, and another to hold data coming from or going to a 
modem. These specialized buffers clearly have many character- 
istics in common, but each has some differences caused by the fact 
that disk files, printers, and modems involve devices that work 
differently. 


The C++ solution to this “similar but different” situation is to al- 
low classes to inherit characteristics and behavior from one or 
more base classes. This is an intuitive leap; inheritance is perhaps 
the single biggest difference between C++ and C. Classes that 
inherit from base classes are called derived classes. And a derived 
class may itself be the base class from which other classes are 
derived (recall the insect family tree). 


The fundamental unit of graphics is the single point on the screen 
(one pixel). So far we’ve devised several variants of a Point class 
that define a point by its X and Y locations, a constructor that 
creates and initializes a point’s location, and other member func- 
tions that can return the point’s current X and Y coordinates. 
Before you can draw anything, however, you have to distinguish 
between pixels that are “on” (drawn in some visible color) and 
pixels that are “off” (have the background color). Later, of course, 
you may want to define which of many colors a given point 
should have, and perhaps other attributes (such as blinking). 
Pretty soon you can end up with a complicated class that has 
many data members. 
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Let’s rethink our strategy. What are the two fundamental kinds of 
information about points? One kind of information describes 
where the point is (location) and the other kind of information 
describes how the point is (the point’s state of being: You can 
either see it, or you can’t, and if you can see it, it is in some color). 
Of the two, the location is most fundamental: Without a location, 
you can’t have a point at all. 


Because all points must contain a location, you can make the class 
Point a derived class of a more fundamental base class, Location, 
which contains the information about X and Y coordinates. Point 
inherits everything that Location has, and adds whatever is new 
about Point to make Point what it must be. 


These two related classes can be defined this way: 


This code is ag /* point. h--Example from Chapter 5 of Getting Started */ 
point.h. 
// point.h contains two classes: 


// class Location describes screen locations in X and Y coordinates 
// class Point describes whether a point is hidden or visible 


enum Boolean {false, true}; 


class Location { 


protected: // allows derived class to access private data 
int. x; 
int Y; 

public: // these functions can be accessed from outside 
Location(int InitX, int InityY); 
int GetX(); 
int GetY(); 

hi 

class Point : public Location { // derived from class Location 


// public derivation means that X and Y are protected within Point 


protected: 

Boolean Visible; // classes derived from Point will need access 
public: 

Point (int InitX, int InitY); // constructor 


void Show(); 

void Hide(); 

Boolean IsVisible(); 

void MoveTo(int NewX, int NewY); 


h; 


Here, Location is the base class, and Point is the derived class. 
The process can continue indefinitely: You can define other 
classes derived from Location, other classes derived from Point, 
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Inheritance and 
access control 


Table 5.1 
Class access 


In a derived class, access to 
the elements of ifs base class 
can be made more 
restrictive but never less 
restrictive. 
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yet more classes derived from Point's derived class, and so on. 
You can even have a class derived from more than one base class: 
This is called multiple inheritance, and will be discussed later. A 
large part of designing a C++ application lies in building this class 
hierarchy and expressing the family tree of the classes in the 
application. 


Before we discuss the various member functions point.h, let’s 
review the inheritance and access control mechanisms of C++. 


The data members of the Location class are declared to be 
protected—recall that this means that member functions in both 
the Location class and the derived class Point will be able to ac- 
cess them, but the “public at large” won’t be able to do so. 


You declare a derived class as follows: 


class D : access modifier B { // default is private 


or 


struct D : access modifier B { // default is public 


} 


D is the name of the derived class, access_modifter is optional 
(either public or private), and B is the name of the base class. 


With class, the default access_modifier is private; with struct, the 
default is public. (Note that unions can be neither base nor 
derived classes.) 


The access_modifier is used to modify the accessibility of inherited 
members, as shown in the following table: 


Access in base class Access modifier Inherited access in base 
public public public 
private public not accessible 
protected public protected 
public private private 
private private not accessible 
protected private private 


When writing new classes that rely on existing classes, make sure 
you understand the relationship between base and derived 
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See Chapter 1, “The Turbo 
C++ language standard,” in 


th 


e Programmers Guide for 


more advanced technical 


Cetails. 


Base class members that you 


want fo use in a derived 
class must be either 


protected or public. private 
base class members can't 


be 
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accessed except by their 
own member functions or 
through friend functions. 


Packaging 
classes INTO 
modules 


classes. A vital part of this is understanding the access levels con- 
ferred by the specifiers private, protected, and public. Access 
rights must be passed on carefully (or withheld) from parents to 
children to grandchildren. C++ lets you do this without “ex- 
posing” your data to non-family and non-friends. The access level 
of a base class member, as viewed by the base class, need not be 
the same as its access level as viewed by its derived class. In other 
words, when members are inherited, you have some control over 
how their access levels are inherited. 


A class can be derived privately or publicly from its base class. 
private derivation (the default for class type classes) converts 
public and protected members in the base class into private 
members of the derived class, while private members remain 
private. (Although private derivation is the default for classes, it is 
by no means the most commonly used method of derivation—so 
we have a rare situation where the default is not the norm). 


A public derivation leaves the access level unchanged. 


A derived class inherits all members of its base class, but can only 
use the protected and public members of its base class. private 
members of the base class are not directly available through the 
members of the derived class. 


The particular definitions of Location and Point adopted here will 
allow us later on to derive further classes from Point for more 
complex graphics applications. 


If you use public derivation, protected members of the base class 
remain protected in the derived class, and thus won’t be available 
from outside except to other publicly derived classes and friends. 
It’s a good idea to always specify public or private, whatever the 
default, to avoid confusion. Good comments, too, will improve 
your source code legibility. 


Classes such as Location and Point can be packaged together for 
use in further program development. With its built-in data, mem- 
ber functions, and access control, a class is inherently modular. In 
developing a program, it often makes sense to put the declara- 
tions for each class or group of related classes in a separate header 
file, and the definitions for its non-inline member functions in a 
separate source file. (See Chapter 2, “Managing multi-file pro- 
jects,” in the User's Guide for details on how to use the Project 
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This code is available as 
POINT2.CPP. 
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Manager to manage programs that consist of multiple source 
files.) 


You can also combine several class object files into a library using 
TLIB. (See Chapter 5, “Utilities,” in the User’s Guide to learn how 
to create libraries.) 


There are further advantages to modularizing classes: You can 
distribute your classes in object form to other programmers. The 
other programmers can derive new, specialized classes from the 
ones you made available, without needing access to your source 
code. Even though C++ version 2.0 is quite new, third-party class 
libraries are already appearing, and you can expect that your 
fellow C++ programmers will be offering many more goodies that 
you can use to get a head start in your programming projects. 


We can now develop a separately compiled “module” containing 
the Location and Point classes. First, the declarations for the two 
classes (including their member functions) as listed on page 142 
are put in the file point.h (on your distribution diskettes). 


Note again how the class Point is derived from the class Location: 
class Point : public Location { ... 


The keyword public is needed before Location to ensure that the 
member functions of the derived class, Point, can access the 
protected members X and Y in the base class, Location. In 
addition to the X and Y location members, Point inherits the 
member functions GetX and GetY from Location. The class Point 
also adds the protected data member Visible (of the enumerated 
type Boolean), and five public member functions, including the 
constructor Point::Point. Note again that we have used protected 
rather than private access for certain elements so that point.h can 
be used in later examples that have further classes derived from 
Location and Point. 


The file POINT2.CPP contains the definitions for all of the mem- 
ber functions of these two classes: 


/* POINT2.CPP--Fxample from Chapter 5 of Getting Started */ 


// POINT2.CPP contains the definitions for the Point and Location 
// classes that are declared in the file point.h 


#include “point .h" 
#include <graphics.h> 


// member functions for the Location class 
Location::Location({int InitX, int InitY) { 


145 


X 
Y 


Initx; 
nici 


}} 
int Location::GetX(void) { 
return X; 
b} 
int Location::GetY(void) { 
return Y; 
b} 
// member functions for the Point class: These assume 
// the main program has initialized the graphics system 


Point::Point(int InitX, int InitY) : Location(InitX,InitY) { 
Visible = false; // make invisible by default 


)} 
void Point::Show(void) { 
Visible = true; | 
putpixel(X, Y, getcolor()); // uses default color 
)} 
vold Point::Hide(void) { 
Visible = false; 
putpixel(X, Y, getbkcolor()); // uses background color to erase 
}; 
Boolean Point::IsVisible(void) { 
return Visible; 
}? 


void Point::MoveTo(int NewX, int NewY) { 


Hide(); // make current point invisible 
X = NewX; // change X and Y coordinates to new location 
Y = NewY; 


Show () ; // show point at new location 
}} 


A base constructor is invoked This example introduces the important concept of base-class con- 
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before the body of the 
derived class constructor. 


structors. When a Point object is defined, we want to make use of 
the fact that its base class, Location, already has its own user- 
defined constructor. The definition of the constructor Point::Point 
begins with a colon and a reference to the base constructor 
Location(InitX InitY). This specifies that the Point constructor will 
first call the Location constructor with the arguments InitX and 
InitY, thereby creating and initializing data members X and Y. 
Then the Point constructor body is invoked, creating and initial- 
izing the data member Visible. By explicitly specifying a base 
constructor, we have saved ourselves some coding (in larger 
examples, of course, the savings may be more significant). 
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You'll need to compile and 
link POINT2.CPP, PIXEL. CPP, 
and GRAPHICS.LIB, using the 
PIXEL.PRJ project file supplied 
on your distribution diskettes. 
(Read Chapter 2, “Manag- 
ing multi-file projects,” in the 
User's Guide if you don't 
know how fo use project 
files.) 
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In fact, derived-class constructors always call a constructor of the 


base class first to ensure that inherited data members are correctly 
created and initialized. If the base class is itself derived, the pro- 
cess of calling base constructors continues down the hierarchy. If 
you don’t define a constructor for a particular class X, C++ will 
generate a default constructor of the form X::X(); that is, a 
constructor with no arguments. 


If the derived-class constructor does not explicitly invoke one of 
its base-class constructors, or if you have not defined a base-class 
constructor, the default base class constructor (with no argu- 
ments) will be invoked. (There’s more on base class constructors 
in Chapter 1, “The Turbo C++ language standard,” in the Pro- 
grammer’s Guide.) 


Notice that the reference to the base class constructor, 
Location(InitX,InitY) appears in the definition, not the declaration, 
of the derived class constructor. 


Here’s a main program (available on your distribution diskettes as 
PIXEL.CPP) that demonstrates the capabilities of the Point and 
Location classes. 


/* PIXEL.CPP--Example from Chapter 5 of Getting Started */ 


// PIXEL.CPP demonstrates the Point and Location classes 
// compile with POINT2.CPP and link with GRAPHICS.LIB 


#include <graphics.h> // declarations for graphics library 


#include <conio.h> // for getch() function 

#include "point .h" // declarations for Point and Location 
classes 

int main() 


{ 
// initialize the graphics system 
int graphdriver = DETECT, graphmode; 
initgraph(&graphdriver, &graphmode, "c:..\\bgi"); 


// move a point across the screen 
Point APoint(100, 50); // Initial X, Y at 100, 50 


APoint .Show(); // APoint turns itself on 
getch(); // Wait for keypress 
APoint .MoveTo(300, 150); // APoint moves to 300,150 
getch(); // Wait for keypress 
APoint.Hide(); // APoint turns itself off 
getch(); // Wait for keypress 
closegraph (); // Restore original screen 
return 0; 
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Extending classes 
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This code is on your Gisks: 
CIRCLE.CPP., 


One of the beauties of classes is the way that new objects can be 
accommodated and given appropriate functionality. The next ex- 
ample takes the already defined Location and Point classes and 
derives a new class, Circle, along with functions to show, hide, 
expand, move, and contract circles. 


/* CIRCLE.CPP--Example from Chapter 5 of Getting Started */ 
// CIRCLE.CPP A Circle class derived from Point 


#include <graphics.h> // graphics library declarations 
#include “point.h" // Location and Point class declarations 
#include <conio.h> // for getch() function 


// link with point2.ob} and graphics.lib 


class Circle : Point { // derived privately from class Point 
// and ultimately from 
class Location 
int Radius; // private by default 


public: 
Circle(int InitX, int InitY, int InitRadius) ; 
void Show(void); 
void Hide (void); 
void Expand(int ExpandBy) ; 
void MoveTo(int NewX, int NewY); 
void Contract (int ContractBy); 
h; 
Circle::Circle(int InitX, int InitY, int InitRadius) : 
Point (InitX,Inity) 
{ 


Radius = InitRadius; 
3 


void Circle::Show(void) 
{ 
Visible = true; 
circle(X, Y, Radius); // draw the circle 


void Circle::Hide (void) 


( 


unsigned int TempColor; // to save current color 

TempColor = getcolor(); // set to current color 
setcolor(getbkcolor()); // set drawing color to background 
Visible = false; 

circle(X, Y, Radius); // draw in background color to erase 
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setcolor(TempColor) ; // set color back to current color 


}; 


void Circle::Expand(int ExpandBy) 


Hide(); // erase old circle 

Radius += ExpandBy; // expand radius 

if (Radius < 0) // avoid negative radius 
Radius = 0; 

Show (); // draw new circle 


b; 


void Circle::Contract (int ContractBy) 


{ 
Expand (-ContractBy) ; // redraws with (Radius - ContractBy) 


7 


void Circle::MoveTo(int NewX, int NewY) 


Hide(); // erase old circle 

X = Newx; // set new location 

Y = NewY; 

Show(); // draw in new location 
bi 
main({) // test the functions 


// initialize the graphics system 
int graphdriver = DETECT, graphmode; 
initgraph(&graphdriver, &graphmode, "c:..\\bgi"); 


Circle MyCircle(100, 200, 50); // declare a circle object 


MyCircle.Show(); // show it 

getch(); // wait for keypress 

MyCircle.MoveTo(200, 250); // move the circle (tests hide 
// and show also) 

getch(); 

MyCircle.Expand (50); // make it bigger 

getch(); 

MyCircle.Contract (75); // make it smaller 

getch(); 

closegraph (); 

return 0; 


To see how this works for the Circle class, you need to examine 
the member functions in the listing CIRCLE.CPP and refresh 
yourself on the class declarations in point.h. 


Note first that the member functions of Circle need to access 
various data members in the classes Circle, Point, and Location. 
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Consider Circle::Expand. It needs access to int Radius. No 
problem. Radius is defined as private (by default) in Circle itself. 
So, Radius is accessible to Circle::Expand—indeed, it is accessible 
only to member functions of Circle. (Later, you'll see that the 
private members of a class can also be accessed by functions that 
have been specially defined as friends of that class.) 


Next, look at the member function Circle::Hide. This needs to 
access Boolean Visible from its base class Point. Now Visible is 
protected in Point, and Circle is derived privately (by default) 
from Point. So, from the rules outlined above, Visible is private 
within Circle, and is accessible just like Radius. Note that if Visible 
had been defined as private in Point, it would have been inaccess- 
ible to the member functions of Circle. So, you might be tempted 
to make Visible public. However, this is overkill: Visible would 
become accessible to non-member functions. You might say that 
protected is private with a dash of public for derived classes: 
member functions of a derived class can access a protected 
member without exposing that member to public abuse. 


Finally, consider Circle::Show. Circle::Show needs to access 
Location’s members X and Y in order to draw the circle. How is 
this achieved? Circle is not directly derived from Location, so the 
access rights are not immediately obvious. Circle derives from 
Point which derives from Location. Let's trace the access 
declarations. 


1. Members X and Y are declared protected in Location. 


2. Point specifies public derivation from Location, so Point also 
inherits the X and Y members as protected. 


3. Circle is derived from Point using the default private 
derivation. 

4. Circle therefore inherits X and Y as private. Circle::Show can 
access X and Y. Note that X and Y are still protected within 
Location. 


Having digested this chain of access rights, you might want to 
consider the situation if a derived class of Circle, such as PieChart 
or Arc, was needed. Yes, you would need to change the derivation 
of Circle from Point—it would need to be a public derivation and 
Radius would need to become protected. 


It should now be pretty easy to see what is going on in 
CIRCLE.CPP. A circle, in a sense, is a fat point: It has everything a 
point has (an X,Y location and a visible/invisible state) plus a 
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radius. Class Circle appears to have only the single member 
Radius, but don’t forget about all the members that Circle inherits 
by being a derived class of Point. Circle has X, Y, and Visible as 
well, even if you don’t see them in the class definition for Circle. 


Compile and link CIRCLE.CPP, POINT2.CPP, and 
GRAPHICS.LIB. The project file CIRCLE.PRJ on your distribution 
diskettes will help you do this. As you press a key, you should see 
a circle. Press a key again and the circle moves. Again, and the 
circle expands, and again and the circle contracts. 


Multiple 


inheritance As we mentioned earlier, a class can inherit from more than one 
base class. This multiple inheritance mechanism was one of the 
main features added to C++ release 2.0. To see a practical 
example, the next program lets you display text inside a circle. 


Your first thought might be to simply add a string data member 
to the Circle class and then add code to Circle::Show so that it 
displays the text with the circle drawn around it. But text and 
circles are really quite different things: When you think of text 
you think of fonts, character size, and possibly other attributes, 
none of which really has anything to do with circles. You could, of 
course, derive a new class directly from Circle and give it text 
capabilities. When dealing with fundamentally different function- 
alities, however, it is often better to create new “fundamental” 
base classes, and then derive specialized classes that combine the 
appropriate features. The next listing, MCIRCLE.CPP, illustrates 
this approach. 


We'll define a new class called GMessage that displays a string on 
the screen starting at specified X and Y coordinates. This class will 
be MCircle’s other parent. MCircle will inherit GMessage::Show 
and use it to draw the text. The relationships of all of the classes 
involved is shown in the next figure. 
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Figure 5.3 
Multiple inheritance Sate Location: { 


int Y: 


- 


class GMessage : Location { 
char *msg; 

Int Font: 
ud Field; 


class Point : Location { 
Int Visible; 


} 


class Circle : Point { 
Int Radius; 


} 


class MCircle : Circle, GMessage { 


} 


This code is available on your /* MCIRCLE.CPP--Example for Chapter 5 of Getting Started */ 
disks: MCIRCLE.CPP. You 
need to run if using // MCIRCLE.CPP Tllustrates multiple inheritance 
MCIRCLE.PRJ. 


#include <graphics.h> // Graphics library declarations 
#include "point.h" // Location and Point class declarations 
#include <string.h> // for string functions 

#include <conio.h> // for console I/0 


// link with point2.obj and graphics.lib 


// The class hierarchy: 
// location->Point->Circle 
// (Circle and CMessage)->MCircle 


class Circle : public Point { // Derived from class Point and 
ultimately 
// from class 

Location 
protected: 

int Radius; 
public: 

Circle(int InitX, int InitY, int InitRadius) ; 

void Show(void); 


}3 
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Class GMessage : public Location { 
// display a message on graphics screen 


char *msg; // message to be displayed 

int Font; // BGI font to use 

int Field; // size of field for text scaling 
public: 


// Initialize message 

GMessage(int msgX, int msgY, int MsgFont, int FieldSize, 
char *text); 

void Show(void); // show message 


3 


class MCircle : Circle, GMessage { // inherits from both classes 


public: 


MCircle(int mcircX, int mcircY, int mcircRadius, int Font, 


char *msq); 


void Show (void); // show circle with message 


}} 


// Member functions for Circle class 


//Circle constructor 
Circle::Circle(int InitX, int InitY, int InitRadius) : 


Point (InitX, InityY) // initialize inherited members 


//also invokes Location constructor 
{ 

Radius = InitRadius; 
3 


void Circle: :Show (void) 
{ 
Visible = true; 
circle(X, Y, Radius); // draw the circle 


// Member functions for GMessage class 


//GMessage constructor 
GMessage::GMessage(int msgX, int msgY, int MsgFont, 
int FieldSize, char *text) : 
Location (msgX, msgY) 
//X and Y coordinates for centering message 
{ 
Font = MsgFont; // standard fonts defined in graph.h 
Field = FieldSize; // width of area in which to fit text 
msg = text; // point at message 


3 


void GMessage: : Show (void) 


{ 
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The :: operator is used to 
specify a function from 


another scope rather than 
(by default) using the func- 
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tion of that name in the 
current scope. 


int size = Field / (8 * strlen(msg)); // 8 pixels per char. 
settext justify (CENTER TEXT, CENTER TEXT); // centers in circle 


settextstyle(Font, HORIZ DIR, size); // if size > 1, 
magnifies 
outtextxy(X, Y, msg); // display the text 


} 


//Member functions for MCircle class 


//MCircle constructor 
MCircle::MCircle(int mcircX, int mcircY, int mcircRadius, int Font, 


char *msg) : Circle (mcircX, mcircY, 


mcircRadius), 


{ 


GMessage (mcircX,mcircY, Font, 2*mcircRadius,msg) 


void MCircle: :Show (void) 


{ 


Circle: :Show(); 
GMessage: :Show(); 


main() //draws some circles with text 


int graphdriver = DETECT, graphmode; 
initgraph(&graphdriver, &graphmode, "c:..\\bgi"); 
MCircle Smal1(250, 100, 25, SANS SERIF FONT, “You"); 
Small .Show() ; 

MCircle Medium(250, 150, 100, TRIPLEX FONT, "“World"); 
Medium. Show () ; 

MCircle Large(250, 250, 225, GOTHIC FONT, “Universe") ; 
Large.Show(); 

getch(); 

closegraph (); 

return 0; 


As you read the listing, check the class declarations and note 
which data members and member functions are inherited by each 
class. You may also want to look at point.h again, since the 
Location and Point classes are defined there. Notice that both 
MCircle and GMessage have Location as their ultimate base class: 
MCircle by way of Point and Circle, and GMessage directly. 


In the body of the definition of MCircle::Show, you will see the 
two function calls Circle::Show(); and GMessage::Show();. This 
syntax shows another common use of :: (the scope resolution 
operator). When you want to call an inherited function, such as 
Show, the compiler may need some help: which Show is re- 
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You'll find a more detailed 
account of how C++ hanales 
scope in Chapter 1, “The 
Turbo C++ language stan- 
dard,” in the Programmers 
Guide. 


See Chapter I, “The Turbo 
C++ language standard,” in 
the Programmer’ Guide for 
details on constructor calling 
sequences. 
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quired? Without the scope resolution “override,” Show() would 
refer to the Show() in the current scope, namely MCircle::Show(). 
To call the Show() of another scope (assuming, of course, that you 
have access permission), you must supply the appropriate class 
name followed by :: and the function name (with arguments, if 
any). What if there happened to be a nonmember function called 
Show that you wanted to call? You would use ::Show() with no 
preceding class name. 


A member function of a given name in the derived class overrides 
the member function of the same name in the base class, but you 
can still get at the latter by using ::. The scoping rules for C++ are 
slightly different from those for C. 


Before leaving MCIRCLE.CPP, a brief word about the constructor 
for MCircle. You saw earlier how the Point constructor explicitly 
invoked its base constructor in Location. Since MCircle inherits 
from both Circle and GMessage, the MCircle constructor can con- 
veniently initialize by calling both base constructors: 


MCircle::MCircle 
(int mcircX, int mcircY, int mcircRadius, int font, char *msg) : 
Circle(mcircX, mcircY, mcircRadius), 
GMessage(mcircX, mcircY, 2*mcircRadius,msg) { 


The constructor body is empty here because all the necessary 
work is accomplished in the member initialization list (after the : 
you enter a list of initializing expressions separated by commas. 
You met a simpler version of this syntax in the single base class 
constructors used in the Point and Circle class definitions). When 
the MCircle constructor is invoked (by declaring an MCircle 
object, for example), quite a spate of activity is triggered behind 
the scenes. 


First, the Circle constructor is called. This constructor then calls 
the Point constructor, which in turn calls the Location constructor. 
Finally, the GMessage constructor is called, which calls the 
Location constructor for its own copy of its base class X and Y. 
The arguments given in the MCircle constructor are passed on to 
initialize the appropriate data members of the base classes. 


When destructors are called (when an object goes out of scope, for 
example), the deallocation sequence is the reverse of that used 
during construction. (Virtual base class constructors and destruc- 
tors have some sequencing quirks beyond the scope of this 
chapter). 
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Figure 5.4 
Circles with messages 


Virtual functions 


In passing, recall the point made earlier: if you don’t supply your 
own constructors or destructors, C++ will generate and invoke 
default versions behind the scenes. 


Figure 5.4 shows the output of MCIRCLE: 
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Each class type in our graphics hierarchy represents a different 
type of figure onscreen: a point or a circle. It certainly makes sense 
to say that you can show a point on the screen, or show a circle. 
Later on, if you were to define classes to represent other figures 
such as lines, squares, arcs, and so on, you could write a member 
function for each that would display that object onscreen. In the 
new way of object-oriented thinking, you could say that all these 
graphic figure types had the ability to show themselves on the 
screen. 


What is different for each object type is the way it must show itself 
onscreen. A point is drawn with a point-plotting routine that 
needs only an X,Y location and perhaps a color value. A circle 
needs a more complex graphics routine to display itself, taking 
into account not only X and Y, but a radius as well. Still further, 
an arc needs a start angle and an end angle, and a different 
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drawing algorithm. The same situation, of course, applies to 
hiding, dragging, and other basic shape manipulations. 


The ordinary member functions you have seen so far certainly 
allow us to define a Show function for each shape class. But they 
lack an essential ingredient. Graphics modules based on our 
existing classes and member functions would need source code 
changes and recompilations each time a new shape class was 
introduced with its own member function Show. The reason is 
that the C++ mechanisms revealed so far allow essentially only 
three ways to resolve the question: which Show is being 
referenced?: 


1. There’s the distinction by argument signature—Show(int,char) 
is not the same function as Show(char’, float), for example. 


2. There’s the use of the scope resolution operator, whereby 
Circle::Show is distinguished from Point::Show and ::Show. 


3. There’s the resolution by class object: ACircle.Show invokes 
Circle::Show, while Apoint.Show invokes Point::Show. 
Similarly with pointers to objects: APoint_pointer->Show 
invokes Point::Show. 


All these function resolutions, so far, have been made at compile 
time—a mechanism which is referred to as early or static binding. 


A typical graphics toolbox would provide the user with class defi- 
nitions in .H source files together with the precompiled .OBJ or 
-LIB code for the member functions. With the early binding re- 
strictions, the user cannot easily add new class shapes, and even 
the developer faces extra chores in extending the package. C++ 
offers a flexible mechanism to solve these problems: late (or dy- 
namic) binding by means of special member functions called 
virtual functions. 


The key concept is that virtual function calls are resolved at run 
time (hence the term, late binding). In practical terms, it means 
that the decision as to which Show function is called can be de- 
ferred until the object type involved is known during execution. A 
virtual function Show, “hidden” in a class B in the precompiled 
toolbox library, is not bound to the objects of B in the way that 
ordinary member functions of B are. You are free to create a class 
D derived from B for your own favorite shape, and write 
appropriate functions (putting on your Show, as it were). You 
then compile and link your OBJ or LIB code to that of the toolbox. 
Calls made on Show, whether from existing member functions of 
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B or from the new functions you have written for D, will 
automatically reference the correct Show. This resolution is made 
entirely on the object type involved in the call. Let’s look at virtual 
functions in action. We have a potential candidate in the earlier 
code given for CIRCLE.CPP 


Consider the member function Circle::MoveTo in CIRCLE.CPP: 


void Circle::MoveTo(int NewX, int NewY) 


Boolean vis = Visible; 


if (vis) Hide(); // hide only if visible 

X = NewX; Y = NewY; // set new location 

if (vis) Show(); // draw at new location if previously 
// visible 


Notice how similar this definition is to Point::MoveTo found in 
the Circle’s base class Point. In fact, the return value, function 
name, number and types of formal arguments (known as the 
function signature), and even the function body itself, all appear to 
be identical! If C++ encounters two function calls using the same 
function name but differing in signatures, we have already seen 
that the C++ compiler is smart enough to resolve the potential 
ambiguities caused by function-name overloading. (Recall that C, 
unlike C++, demands unique function names.) In C++, member 
functions with different signatures are really different functions, 
even if they share the same name. 


But, our two MoveTos do not, at first sight, offer any distinguish- 
ing clues to the compiler—so will it know which one you in- 
tended to call? The answer, as you've seen, with ordinary member 
functions is that the compiler determines the target function from 
the class type of the object involved in the call. 


So, why not let Circle inherit Point's MoveTo, just as Circle inher- 
its Point's GetX and GetY (via Location)? The reason, of course, is 
that the Hide and Show called in Circle::MoveTo are not the same 
Hide and Show called in Point::MoveTo. Only the names and 
signatures are the same. Inheriting MoveTo from Point would 
lead to the wrong Hide and Show being called when trying to 
move a circle. Why? Because Point's versions of these two func- 
tions would be bound to Point's (and hence also to Circle’s) 
MoveTo at compile time (early binding). As you may have 
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guessed already, the answer is to declare Hide and Show as 
virtual functions. This will delay the binding so that the correct 
versions Hide and Show can be invoked when MoveTo is actually 
called to move a point or a circle (or whatever). 


Note again that if we wanted to precompile our class definitions 
and member functions for Location, Point, and Circle in a neat 
standalone library (with the implementation source locked up 
with our other trade secrets), we certainly could not know in 
advance the objects that MoveTo may be asked to move. Virtual 
functions not only provide this technical advantage; they also 
provide a conceptual gain that lies at the heart of OOP. We can 
concentrate on developing reusable classes and methods with less 
anxiety about name clashes. 


While it is true that add-on library extensions are available for 
most languages, the use of virtual functions and multiple inheri- 
tance in C++ makes extensibility more natural. You inherit 
everything that all your base classes have, and then you add the 
new capabilities you need to make new objects work in familiar 
ways. The classes you define and their versions of the virtual 
functions become a true extension of an orderly hierarchy of 
capabilities. Because this is part of the language design rather 
than an afterthought, there is very little penalty in performance. 


Having sold you on the merits of virtual functions, let’s see how 
you can implement them, and some of the rules you have to 
follow. 


The syntax is straightforward: add the qualifier virtual in the 
member function’s first declaration: 


virtual void Show(); 
virtual void Hide(); 


Important! Only member functions can be declared as virtual. 
Once a function is declared virtual, it must not be redeclared in 
any derived class with the same formal argument signature but 
with a different return type. If you redeclare Show with the same 
formal argument signature and same return type, the new Show 
automatically becomes virtual, whether you use the virtual 
qualifier or not. This new, virtual Show is said to override the 
Show in its base class. 
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You are free to redeclare Show with a different formal argument 
signature (whether you change the return type or not)—but the 
virtual mechanism is inoperable for this version of Show. 
Beginners should avoid rash overloading—there are situations 
where a non-virtual function can hide a virtual function declared | 
in its base. | 


The particular Show called will depend only on the class of the 
object for which Show is invoked, even if the call is invoked via a 
pointer (or reference) to the base class. For example, 


Circle ACircle; 

Point* APoint pointer = &ACircle; // pointer to Circle assigned to 
// pointer to base class, Point 

APoint pointer->Show(); // calls Circle: :Show! 


vpoint.h and VCIRC.CPP (available on your distribution 
diskettes) are versions of point-h and CIRCLE.CPP with Show 
and Hide made virtual. Compile VCIRC.CPP with POINT2.CPP 
using VCIRC.PRJ. It will run exactly like CIRCLE.CPP. We don’t 
list the virtual versions in full here since the differences can be 
summed up simply as follows: 


u In vpoint.h, Point's Show and Hide have been declared with the 
keyword virtual. The Show and Hide in the VCIRC’s derived 
class Circle have the same argument signature and return 
values as the base versions in Point; this implies that they are 
also virtual, even though the keyword virtual is not used in 
their declarations. 

a In VCIRC.CPP, Circle no longer has its own MoveTo member 
function. 


m We now derive Circle publicly from Point to allow access to 
MoveTo 


To recap the significance of these changes: 


Circle objects can now safely call the MoveTo inherited from 
Point. The Show and Hide called by MoveTo will be bound at run 
time to Circle’s own Show and Hide. Any Point objects calling 
MoveTo will invoke the Point versions. 


As a more complete and realistic example of virtual functions, let’s 
create a module that defines some shape classes and a generalized 
means of dragging them around the screen. This module, 
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figures.h and FIGURES.CPP (on your distribution diskettes), is a 
simple implementation of the graphics toolbox discussed earlier. 


A major goal in designing the FIGURES module is to allow users 
of the module to extend the classes defined in the module—and 
still make use of all the module’s features. It is an interesting chal- 
lenge to create some means of dragging an arbitrary graphics fig- 
ure around the screen in response to user input. 


As a first approach, we might consider a function that takes an 
object as an argument, and then drags that object around the 
screen: 


void Drag(Point& AnyFigure, int DragBy) 

{ 
int DeltaX,DeltaY; 
int Figurex,FigureyY; 
AnyFigure.Show(); // Display figure to be dragged 
FigureX = AnyFigure.GetX(}; // Get the initial X,Y of figure 
FigureY = AnyFigure.GetY(); 


// This is the drag loop 

while (GetDelta(DeltaX, DeltaY)) 

{ 
// Apply delta to figure X,Y 
FigureX = FigureX + (DeltaX * DragBy); 
FigureY = FigureY + (DeltaY * DragBy); 
// And tell the figure to move 
AnyFigure.MoveTo(Figurex, FigureY); 

li 

hi 


Reference types Notice that AnyFigure is declared to be of type Point&. This means 
“a reference to an object of type Point” and is a new feature of 
C++. As you know, C ordinarily passes arguments by value, not 
by reference. In C, if you want to act directly on a variable being 
passed to a function, you have to pass a pointer to the variable, 
which can lead to awkward syntax, since you have to remember 
to dereference the pointer. C++ lets you pass and modify the 
actual variable by using a reference. To declare a reference, simply 
follow the data type with an ampersand (&) in the variable 
declaration. 


Drag calls an auxiliary function not shown here, GetDelta, that 
obtains some sort of change in X and Y from the user. It could be 
from the keyboard, or from a mouse, or a joystick. (For simplic- 


Chapter 5, A C++ primer 161 


ity’s sake, our example obtains input from the arrow keys on the 
keyboard.) 


An important point to notice about Drag is that any object of type 
Point, or any type derived from Point, can be passed in the 
AnyFigure reference argument. Objects of Point or Circle type, or 
any type defined in the future that inherits from Point or Circle, 
can be passed without complication in AnyFigure. 


Adding a new member function to an existing class hierarchy 
involves a little thought. How far up the hierarchy should the 
member function be placed? Think about the utility provided by 
the function and decide how broadly applicable that utility is. 
Dragging a figure involves changing the location of the figure in 
response to input from the user. In terms of inheritability, it sits 
right beside MoveTo—any object to which MoveTo is appropriate 
should also inherit Drag. Therefore Drag should be a member of 
Point, so that all of Point's derived types can share it. 


Having resolved the place of Drag in the hierarchy, we can take a 
closer look at its definition. As a member function of the base 
class Point, there is no need for the explicit reference to the Point& 
AnyFigure argument. We can rewrite Drag so that the functions it 
calls, such as GetX, Show, MoveTo, and Hide, will correctly 
reference the versions appropriate to the type of the object being 
dragged. As we saw earlier, the functions Show and Hide that 
require special shape-related code can be made virtual. We can 
then redefine them for any future classes without disturbing the 
FIGURES module. This also takes care of MoveTo, since MoveTo 
calls the correct Show and Hide (you'll recall that that was our 
original motivation for making Show and Hide virtual). GetX and 
GetY present no problem: as ordinary member functions inherited 
from Point via Location, they simply return the X and Y data 
members of the calling object of any derived class, present or 
future. Remember, though, that X and Y are protected in 
Location, so we must use public derivation as shown. 


The next design decision is whether to make Drag virtual. The 
litmus test for making any function virtual is whether its function- 
ality is expected to change somewhere down the hierarchy. There 
is no golden rule here, but later on we'll discuss the various 
tradeoffs: extensibility versus performance overhead (virtual 
functions require slightly more memory and a few more 
memory-access cycles). We have taken the view that some future 
class in, say, a CAD (Computer Aided Design) application might 
conceivably need a special dragging action. Perhaps dragging an 


162 Turbo C++ Geftting Started — 


Remember to recompile 
everything that uses this 
header file. 


This code is on your disks: 
figures.h. 


Chapter 5, A C++ primer 


isometric drawing will require some scaling actions, and so on. In 


our new Point class definition in figures.h, we have therefore 
made Drag virtual. 


class Point : public Location { 


protected: 
Boolean Visible; 
public: 
Point (int InitX, int InitY); 
virtual void Show(); // Show and Hide are virtual 


virtual void Hide(); 
Boolean IsVisible() {return Visible; } 
void MoveTo(int NewX, int NewY); 
virtual void Drag(int DragBy) ; 

b} 


Here is the header file figures.h containing the class declarations 
for the FIGURES module. This is the only part of the package that 


needs to be distributed in source code form: 


// figures.h contains three classes. 


// Class Location describes screen locations in X and Y 
// coordinates. 


// Class Point describes whether a point is hidden or visible. 


// Class Circle describes the radius of a circle around a point. 


// To use this module, put #include <figures.h> in your main 
// source file and compile the source file FIGURES.CPP together 
// with your main source file. 


enum Boolean {false, true}; 


class Location { 
protected: 
inc: Xj 
int 2Y; 
public: 
Location(int InitX, int InitY) {X = InitX; Y = InitY;} 
int GetX({) {return X;} 
int GetY() {return Y;} 
}; 


class Point : public Location { 
protected: 

Boolean Visible; 
public: 

Point (int InitX, int InitY); 
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to GRAPHICS.LIB to get 
FIGURES. OBJ. You'll need 
FIGURES.OBJ for the next 
exercise. 


virtual void Show(); // Show and Hide are virtual 
virtual void Hide(); 
virtual void Drag(int DragBy); // new virtual drag function 
Boolean IsVisible() {return Visible; } 
void MoveTo(int NewX, int NewY); 
}i 
class Circle : public Point { // Derived from class Point and 
| // ultimately from class Location 
protected: 
int Radius; 
public: 
Circle(int Initx, int InitY, int InitRadius); 
void Show(); 
void Hide(); 
void Expand(int ExpandBy) ; 
void Contract (int ContractBy) ; 
}; 
// prototype of general-purpose, non-member function 
// defined in FIGURES.CPP 


Boolean GetDelta(int& Deltax, inté& DeltaY); 


Here is the file FFGURES.CPP containing the member function 
definitions. This is what would be distributed in object or library 
form commercially. Note that we have defined the Circle con- 
structor outside the class since it invokes base constructors. You 
may wish to experiment by making it an inline function (see the 
discussion on page 175). The nonmember function GetDelta will 
repay some study if you are new to C. Note the use of reference 
arguments, which is a C++ touch; the rest of the code is 
traditional. 


// FIGURES.CPP: This file contains the definitions for the Point 
// class (declared in figures.h). Member functions for the 
// Location class appear as inline functions in figures.h. 


#include "figures.h" 
#include <graphics.h> 
#include <conio.h> 


// member functions for the Point class 
//constructor 
Point::Point(int InitX, int InitY) : Location (InitX, InityY) 


{ 
Visible = false; // make invisible by default 


void Point: :Show() 
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Visible = true; 
putpixel(X, Y, getcolor()); // uses default color 
} 


void Point: :Hide() 
{ 
Visible = false; 
putpixel(X, Y, getbkcolor()); // uses background color to erase 


void Point::MoveTo(int NewX, int NewY) 


Hide(); // make current point invisible 

X = NewX; // change X and Y coordinates to new location 
Y = NewY; 

Show () ; // show point at new location 


// a general-purpose function for getting keyboard 
// cursor movement keys (not a member function) 


Boolean GetDelta(int& DeltaX, int& DeltayY) 
{ 

char KeyChar; 

Boolean Quit; 


DeltaX = 0; 
DeltaY = 0; 
do 


KeyChar = getch(); // read the keystroke 


if (KeyChar == 13) // carriage return 
return (false) ; 

if (KeyChar == 0) // an extended keycode 
{ 
Quit = true; // assume it is usable 


KeyChar = getch(); // get rest of keycode 
switch (KeyChar) { 
case 72: DeltaY = -1; break; // down arrow 
case 80: DeltaY = 1; break; // up arrow 
case 75: DeltaX = -1; break; // left arrow 
case 77: DeltaX = 1; break; // right arrow 
default: Quit = false; // bad key 
3 
hi 
} while (!Quit); 
return (true) ; 


void Point: :Drag(int DragBy) 


{ 
int DeltaX, DeltaY; 
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int Figurex, FigureyY; 


Show(); // display figure to be dragged 
FigureX = GetX(); // get initial position of figure 
FigureY = GetY(); 


// This is the drag loop 
while (GetDelta(Deltax, DeltaY)) 


// Apply delta to figure at X, Y | 
FigureX += (DeltaX * DragBy); 
FigureY t= (DeltaY * DragBy); 
MoveTo(FigureX, FigureY); // tell figure to move 
}? 
} 


// Member functions for the Circle class 


//constructor 
Circle::Circle(int InitX, int InitY, int InitRadius) : Point (Initx, 
InityY) 
{ 
Radius = InitRadius; 


void Circle::Show() 


{ 
Visible = true; 
circle(X, Y, Radius); // draw the circle 


void Circle::Hide() 


{ 


unsigned int TempColor; 
TempColor = getcolor()}; 
setcolor(getbkcolor()); 
Visible = false; 
circle(X, Y, Radius); 
setcolor(TempColor) ; 


// to save current color 
// set to current color 
// set drawing color to background 


// draw in background color to 
// set color back to current color 


void Circle::Expand(int ExpandBy) 


{ 
Hide(); 
Radius += ExpandBy; 
if (Radius < 0) 
Radius = 0; 
Show (); 
} 


// erase old circle 
// expand radius 
// avoid negative radius 


// draw new circle 


void Circle::Contract (int ContractBy) 


Expand (-ContractBy) ; 


// redraws with (Radius-ContractBy) 
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We are now ready to test FIGURES by exposing it to a new shape 
class called Are that is defined in FIGDEMO.CPP. Are is 
(naturally) derived publicly from Circle. Recall that Drag is about 
to drag a shape it has never seen before! 


This code is on your disks as // FIGDEMO.CPP -- Exercise for Chapter 5 
FIGDEMO.CPP. You need to 
compile it and link it to // demonstrates the Figures toolbox by extending it with 
FIGURES. OBJ. // a new type Arc. 


// Link with FIGURES.OBJ and GRAPHICS.LIB 


#include "figures.h" 
#include <graphics.h> 
#include <conio.h> 


class Arc : public Circle { 
int StartAngle; 
int EndAngle; 
public: 
// constructor 
Arc(int InitX, int InitY, int InitRadius, int InitStartAngle, int 
InitEndAngle) : Circle (InitX, InitY, InitRadius) { 
StartAngle = InitStartAngle; EndAngle = InitEndAngle; } 
void Show(); // these functions are virtual in Point 
void Hide(); 
hi 


// Member functions for Arc 


void Arc: :Show({) 
{ 

Visible = true; 

arc(X, Y, StartAngle, EndAngle, Radius) ; 
} 


void Arc: :Hide() 
{ 
int TempColor; 
TempColor = getcolor(); 
setcolor (getbkcolor()); 
Visible = false; 
// draw arc in background color to hide it 
arc(X, Y, StartAngle, EndAngle, Radius); 
setcolor(TempColor) ; 


int main() // test the new Arc class 


{ 
int graphdriver = DETECT, graphmode; 
initgraph(&graphdriver, &graphmode, "c:..\\bgi"); 
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Circle ACircle(151, 82, 50); 
Arc AnArc(151, 82, 25, 0, 190); 


// you first drag an arc using arrow keys (5 pixels per key) 
// press Enter when tired of this! 

// Now drag a circle (10 pixels per arrow key) 

// Press Enter to end FIGDEMO. 


AnArc.Drag(5); // drag increment is 5 pixels 
AnArc.Hide(); 

ACircle.Drag(10); // now each drag is 10 pixels 
closegraph (); 

return 0; 


In general, because calling a non-virtual member function is a 
little faster than calling a virtual one, we recommend that you use 
ordinary member functions when extensibility is not a 
consideration, but performance is. Use virtual functions 
otherwise. 


To recap our earlier discussion, let’s say you are declaring a class 
named Base, and within Base you are declaring a member func- 
tion named Action. How do you decide whether Action should be 
virtual or ordinary? Here’s the rule of thumb: Make Action virtual 
if there is a possibility that some future class derived from Base 
will override Action, and you want that future code to be accessi- 
ble to Base. Make Action ordinary if it is evident that for derived 
types, Action will perform the same steps (even if this involves 
invoking other, virtual, functions); or the derived types will not 
make use of Action. 


Dynamic objects 
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All the examples shown so far, except for the message array allo- 
cation in MCIRCLE.CPP, have had static or automatic objects of 
class types that were declared as usual with their memory being 
allocated by the compiler at compile time. In this section we look 
at objects that are created at run time, with their memory 
allocated from the system’s free memory store. The creation of dyna- 
mic objects is an important technique for many programming 
applications where the amount of data to be stored in memory 
cannot be known before the program is run. An example is a 
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assign the result of the 
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use the pointer to refer fo the 
newly created object. 


You can find this on your 
disks: DYNPOINT.CPP. Or use 
DYNPOINT. PRJ. 
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free-form database program that holds data records of various 
sizes in memory for rapid access. 


C++ can use the dynamic memory allocation functions of C such 
as malloc. However, C++ includes some powerful extensions that 
make dynamic allocation and deallocation of objects easier and 
more reliable. More importantly, it ensures that constructors and 
destructors are called. For example, 


Circle *ACircle = new Circle(151,82,50); 


Here ACircle, a pointer to type Circle, is given the address of a 
block of memory large enough to hold one object of type Circle. In 
other words, ACircle now points to a Circle object allocated from 
free store. A Circle constructor is then called to initialize the object 
according to the arguments supplied. 


If you are allocating an array rather than a standard-length data 
type, use the optional syntax 


new object [size] 


For example, to dynamically allocate an array of 50 integers called 
counts, use 


counts = new int [50]; 


If you wanted to create a dynamic Point class object, you might 
do it like this: 


// DPOINT.CPP -- exercise in Chapter 5, Getting Started 


#include <iostream. h> 
#include <graphics.h> 
#include <conio.h> 
#include “figures.h" 


int main() 

{ 

// Assign pointer to dynamically allocated object; call constructor 
Point *APoint = new Point(50, 100); 


// initialize the graphics system 
int graphdriver = DETECT, graphmode; 
initgraph(&graphdriver, &graphmode, "..\\bgi"); 


// Demonstrate the new object 

APoint~>Show() ; 

cout << "Note pixel at (50,100). Now, hit any key..."; 
getch() ; | 

delete APoint; 

closegraph (); 
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delete 


You can find more on 
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mer’s Guide. 


An example of 


allocation 


return (0); 


Just as you can define a constructor that will be called whenever a 
new object of a class is created, you can define a destructor that 
will be called when it is time to destroy an object, that is to say, 
clear its value and deallocate its memory. 


Space for static objects is allocated by the compiler; the 
constructor is called before main and the destructor is called after 
main. In the case of auto objects, deallocation occurs when the 
declaration goes out of scope (when the enclosing block 
terminates). Any destructor you define is called at the time the 
static or auto objects is destroyed. (If you haven't defined a 
destructor, C++ uses an implicit, or built-in one.) 


If you create a dynamic object using the new operator, however, 
you are responsible for deallocating it, since C++ has no way of 
“knowing” when the object is no longer needed. You use the 
delete operator to deallocate the memory. Any destructor you 
have defined is called when delete is executed. 


The delete operator has the syntax 
delete pointer; 


where pointer is the pointer that was used with new to allocate the 
memory. 


You have seen that a constructor for the class X is identified by 
having the same name, viz X::X(). The name of a destructor for 
class X is X::~X(). In addition to deallocating memory, destructors 
can also perform other appropriate actions, such as writing mem- 
ber field data to disk, closing files, and so on. 


The next example program provides some practice in the use of 
objects allocated dynamically from free store, including the use of 
destructors for object deallocation. The program shows how a 
linked list of graphics objects might be created in memory and 
cleaned up using delete calls when the objects are no longer 
required. 
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declarations of List and 
Node. 


This code is on your disks as 
LISTDEMO.CPP. 
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Building a linked list of objects requires that each object contain a 
pointer to the next object in the list. Type Point contains no such 
pointer. The easy way out would be to add a pointer to Point, and 
in doing so ensure that all Point's derived types also inherit the 
pointer. However, adding anything to Point requires that you 
have the source code for Point, and as noted earlier, one advan- 
tage of C++ is the ability to extend existing objects without 
necessarily being able to recompile them. So for this example 
we'll pretend that we don’t have the source code to Point and 
show how you can extend the graphics tool kit anyway. 


One of the many solutions that requires no changes to Point is to 
create a new class not derived from Point. Type List is a very 
simple class whose purpose is to head up a list of Point objects. 
Because Point contains no pointer to the next object in the list, a 
simple struct, Node, provides that service. Node is even simpler 
than List, in that it has no member functions and contains no data 
except a pointer to type Point and a pointer to the next node in the 
list. 


List has a member function that allows it to add new figures to its 
linked list of Node records by inserting a new Node object imme- 
diately after itself, as a referent to its Nodes pointer member. The 
Add member function takes a pointer to a Point object, rather than 
a Point object itself. Remember that rules for the class hierarchy in 
C++ allows pointers to any type publicly derived from Point to be 
passed in the Item argument to List::Add. 


Program ListDemo declares a static variable, AList, of type List, 
and builds a linked list with three nodes. Each node points to a 
different graphics figure that is either a Point or one of its derived 
classes. The number of bytes of free storage space is reported be- 
fore any of the dynamic objects are created, and then again after 
all have been created. Finally, the whole structure, including the 
three Node records and the three Point objects, is cleaned up and 
removed from memory, thanks to the destructor for the List class 
called automatically for its object AList. 


/* LISTDEMO.CPP--Example from Chapter 5 of Getting Started */ 
// LISTDEMO.CPP Demonstrates dynamic objects 
// Link with FIGURES.OBJ and GRAPHICS.LIB 


#include <conio.h> // for getch{) 
#include <alloc.h> // for coreleft () 
#include <stdlib.h> // for itoa() 
#include <string.h> // for strepy({) 
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#include <graphics.h> 
#include "figures.h" 


class Arc ;: public Circle { 
int StartAngle, EndAngle; 
public: 
// constructor 
Arc(int InitX, int InitY, int InitRadius, int InitStartAngle, . 
int InitEndAngle); | 
// virtual functions 
void Show({); 
void Hide(); 
b; 


struct Node { // the list item 
Point *Item; // can be Point or any class derived from Point 
Node *Next; // point to next Node object 

hi 


class List { // the list of objects pointed to by nodes 
Node *Nodes; // points to a node 
public: 
// constructor 
List (); 
// destructor 
~List (); 
// add an item to list 
void Add(Point *NewItem); 
// list the items 
void Report (); 
hi 


// definitions for standalone functions 


void OutTextLn(char *TheText) 


{ 
outtext (TheText) ; 
moveto(0, gety() + 12);  // move to equivalent of next line 


} 


void MemStatus(char *StatusMessage) 


{ 


ev 


unsigned long MemLeft; // to match type returned by 
// coreleft () 
char CharString[12]; // temp string to send to outtext () 
outtext (StatusMessage) ; 
MemLeft = long (coreleft()); 


// convert result to string with ltoa then copy into 
// temporary string 

ltoa(MemLeft, CharString, 10); 

OutTextLn (CharString) ; 
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} 
// member functions for Arc class 


Arc::Arc(int InitX, int InitY, int InitRadius, int InitStartAngle, 
int InitEndAngle) : Circle (InitX, InitY, InitRadius) 
// calls Circle 
// constructor 


StartAngle = InitStartAngle; 
EndAngle = InitEndAngle; 


void Arc::Show() 
{ 

Visible = true; 

arc({X, Y, StartAngle, EndAngle, Radius); 
} 


void Arc::Hide() 
{ 
unsigned TempColor; 
TempColor = getcolor(); 
setcolor (getbkcolor(}); 
Visible = false; 
arc(X, Y, StartAngle, EndAngle, Radius); 
setcolor(TempColor) ; 


} 
// member functions for List class 


List::List () { 
Node *N; 
= new Node; 
N->Item = NULL; 
N->Next = NULL; 
Nodes = NULL; // sets node pointer to “empty" 
// because nothing in list yet 


List::~List () // destructor 


{ 
while (Nodes '= NULL) { // until end of list 


Node *N = Nodes; // get node pointed to 

delete (N->Item) ; // delete item's memory 

Nodes = N->Next; // point to next node 
delete N; // delete pointer’s memory 


3 
} 


void List::Add(Point *NewItem) 
{ 


Node *N; // N is pointer to a node 
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N = new Node; // create a new node 
N->Item = NewItem; // store pointer to object in node 
N->Next = Nodes; // next item points to curent list pos 
Nodes = N; // last item in list now points 

// to this node 


void List::Report () 


char TempString[12]; 
Node *Current = Nodes; 
while (Current != NULL) 
| 
// get X value of item in current node and convert to string 
itoa(Current->Item->GetX(), TempString, 10); 
outtext ("X = "); 
OutTextLn (TempString) ; 
// do the same thing for the Y value 
itoa(Current->Item->GetY(), TempString, 10); 
outtext (“Y = "); 
Out TextLn (TempString) ; 
// point to the next node 
Current = Current->Next; 


}; 


void setlist(void); 


// Main program 
main() 


int graphdriver = DETECT, graphmode; 
initgraph(égraphdriver, &graphmode, "c:..\\bgi"); 


MemStatus ("Free memory before list is allocated: "); 
setlist (); | | 
MemStatus ("Free memory after List destructor: "); 
getch(); 

closegraph {) ; 


void setlist() { 


// declare a list (calls List constructor} 
List AList; 


// create and add several figures to the list 
Arc *Arcl = new Arc(151, 82, 25, 200, 330); 
AList..Add(Arcl); 

MemStatus ("Free memory after adding arcl: "); 
Circle *Circlel = new Circle(200, 80, 40); 
AList .Add(Circlel) ; 
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MemStatus ("Free memory after adding circlel: "); 

Circle *Circle2 = new Circle(305, 136, 35); 

AList .Add(Circle2) ; 

MemStatus ("Free memory after adding circle2: "); 

// traverse list and display X, Y of the list’s figures 
AList.Report () ; 

// The 3 Alist nodes and the Arc and Circle objects will be 
// deallocated automatically by their destructors when they 
// go out of scope in main(). Arc and Circle use implicit 
// destructors in contrast to the explicit ~List destructor. 
// However, you could delete explicitly here if you wish: 
// delete Arcl; delete Circlel; delete Circle2; 

getch(); // wait for a keypress 

return; 


Once you have mastered LISTDEMO.CPP, you might wish to 
develop a more satisfying solution based on the following idea: 
define a new class called PointList by multiple inheritance from 
classes Point and List. 


More flexibility in C++ 


Although it will take you some time to master the nuances of this 
new style of programming, you have now learned the essential 
elements of C++. There are a number of additional features that 
we touch on briefly here so that you will know what they are and 
how to use them. 


None ofthese features are —_ Inline functions outside class definitions 
essential to understanding : 
C++, but they canaddtoifs ™ Default function arguments 
flexibility and power. —_w Overloading functions and multiple constructors 
w Friend functions—another way of providing access to a class 
w Overloading operators to provide new meanings 


m More about C++ I/O and the streams library 


Inline functions 


outside class You have already seen that you can include an inline definition of 


definitions 2 member function within the class declaration as shown here 
with the Point class: 


class Point: { // define Point class 
int X; // these are private by default 
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int -Y; 
public: // public member functions 
Point (int InitX, int InitY) {X = InitX, Y = InitY;} 
int GetX(void) {return X;} 
int GetY({void) {return Y;} 
be 


All three member functions of the Point class are defined inline, 

so no separate definition is necessary. For functions with only a 
line or so of code, this provides a more compact, easier to read de- | 
scription of the class. 


Remember that inline code is Functions can also be declared as inline. The only difference is that 
enclosed in braces. voy have to start the function declaration with the keyword 
inline. For example, in LISTDEMO.CPP, there is an operation that 
simply moves the output location for text in graphics mode down 
one line (it is used in the function OutTextLn). If this function 
were to be used in many other places in the code, it would be 
more efficient to declare it as a separate inline function: 


inline void graphLn() { moveto(0, gety() + 12); } 


If you wish, you can format your inline definitions to look more 
like a regular function definition: 


inline void graphLn () 
{ 
moveto(0, gety() + 12); 


Another advantage to using the inline keyword is that you can 
avoid revealing your implementation code in the distributed 
header files. 


Functions with 


default You can define functions that you can call with fewer arguments 
arguments than defined. The arguments that you don’t supply are given de- 
fault values. If you are going to be using these default values most 
if you plan fo use certain of the time, such an “abbreviated” call saves typing. You don’t 


values offen for a function, Pier: : 
use those values as defauit 108¢ flexibility, because when you want to override the defaults, 


arguments for the function, YOu simply specify the values you want. 


Default values must be ; ; , 
specified the first time the For example, the following version of the constructor for the Circle 


function name is given. Class gives a default circle of radius 50 pixels centered at (X = 200, 
Y = 200). A more portable program, of course, would have to 
determine the graphics hardware available and adjust these 
values accordingly. 
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As with ANSI C, C++ allows 
functions fo have a variable 
number of arguments, such 
as float average {int 
number, ...}), whichcan 
take one or more integer 
values. See Chapter 1, “The 
Turbo C++ language stan- 
dard,” in the Programmer’ 
Guide for details. 


More about 
overloading 
functions 
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class Circle : public Point { // Derived from class Point and 
// ultimately from class Location 
protected: 
int Radius; 
public: 
Circle(int InitX = 200, int InitY = 200, int InitRadius = 50); 
void Show(void); 
void Hide(void) ; 
vold Expand(int ExpandBy) ; 
void Contract (int ContractBy) ; 
hi 


Now the declaration 
Circle ACircle; 


gives you a circle with the default center at (200,200) and radius 
50. The declaration 


Circle ACircle(50, 100); 
gives a circle with center at 50, 100, with the default radius of 50. 
The declaration 

Circle ACircle(300) 
gives a circle at X = 300, with default Y = 200 and radius = 50. 


Any default arguments must be in consecutive rightmost posi- 
tions in the argument list. For example, you couldn’t declare 


void func(int a = 10, int b, int c) 


because the compiler wouldn’t know which values are being 
supplied. 


Overloading is an important and pervasive concept in C++. When 
several different functions (whether member functions or 
ordinary) are defined with the same name within the same scope, 
they are said to be overloaded. You have met several such cases; 
for example, the three functions called cube on page 128. (Earlier 
versions of C++ required that such declarations be preceded by 
the keyword overload, but this is now obsolete.) 


The basic idea is that overloaded function calls are distinguished 
by comparing the types of the actual arguments in the call and the 
formal argument signatures in the function definitions. The actual 
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You can load and run 
STRING.CPP from the IDE. 


After running it, you'll have to 


activate the User Screen fo 
see the output. Use the hot 
key Alt-F5 or the Window | User 
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Screen menu item. 


rules for disambiguation are beyond the scope of a primer and 
should rarely affect the beginner (who is hereby cautioned against 
the rash replication of function names). Among the possible 
complications are functions called with default actual arguments, 
or with a variable numbers of arguments; also, there are the nor- 
mal C conversions of argument type to be considered, together 
with additional type conversions peculiar to C++. When faced 
with a call to a heavily overloaded function, the compiler tries to 
find a best match. If there is no best match, a compiler error results. 


One of the most common cases is overloading a constructor so as 
to provide several different ways to create a new object of a class. 
To illustrate this, we will define a very simple String class. (For 
some fully functional string classes, refer to the books in the 
bibliography.) 


//STRING.CPP--Example from Chapter 5 of Getting Started */ 


#include <iostream.h> 
#include <string.h> 


class String { 
char *char ptr; // pointer to string contents 
int length; // length of string in characters 

public: 
// three different constructors 
String(char *text); // constructor using existing string 
String(int size = 80); // creates default empty string 
String (Stringé Other String); // for assignment from another 

// object of this class 

~String() {delete char ptr;}; 
int Get_len (void); 
void Show (void); 


); 


String::String (char *text) 

{ 
length = strlen(text); // get length of text 
char ptr = new char{length + 1]; 
strcpy (char ptr, text); 

bF 

String::String (int size) 

{ 
length = size; 
Char ptr = new char|lengtht1]; 
*char ptr = '\0'; 

h; 


String::String (Stringé Other String) 
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When calling a constructor 
with no arguments (or when 
accepting all default argu- 
ments), don't put empty 
parentheses after the name 
of the object. For example, 
declare String BString;, 
not String BString();. 
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length = Other String.length; // length of other string 
char ptr = new char [length + 1]; // allocate the memory 
strepy (char ptr, Other String.char ptr); // copy the text 

hi 

int String::Get_len (void) 

{ 
return (length); 

hi 


void String: :Show(void) 
{ 
cout << char ptr << "\n"; 


}; 


main () 


String AString ("Allocated from a constant string."); 
AString.Show() ; 


// test the functions 


String BString; // uses default length 
cout << "\n" << BString.Get len() << “\n" ; //display length 
BString = “This is BString"; 


// invokes the third constructor 
// note its contents 


String CString (BString) ; 
CString.Show(); 


The class String has three different constructors. The first takes an 
ordinary string constant such as “This is a string” and initializes a 
string with these contents. The second constructor uses a default 
length of 80, and allocates the string without storing any charac- 
ters in it (this might be used to create a temporary buffer). Note 
that you.can override the default simply by calling the constructor 
with a different length: Instead of declaring String AString, you 
could declare, for example, String AString (40). 


The third constructor takes a reference to another object of type 
String (recall that the ampersand after a type means a reference to 
that type, and is used to pass the address of a variable rather than 
a copy of its contents.) With this constructor you can now write 
statements such as these: 


String AString("This is the first string"); // create and initialize 
String BString = Astring; // create then assign BString from AString 


Note that constructors are involved in three related but separate 
aspects of an object’s life story: creation, initialization, and 
assignment. The use of the = operator for class assignments leads 
us nicely to our next topic, operator overloading. Unless you 
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Overloading 
operators to 
provide new 

meanings 


Whitespace is okay between 
the keyword operator and 
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the operator symbol. 


define a special = operator for a class, C++ defaults to a member- 
by-member assignment. 


C++ has a special feature found in few other languages: existing 
operators such as + can be given new definitions to make them 
work in an appropriate, user-defined manner with your own class 
objects. Operators are a very concise way of doing business. If you 
didn’t have them, an expression such as line * width + pos would 
have to be written something like this: add (mult (line, width),pos). 
Fortunately, the arithmetic operators in C (and C++) already 
know how to work with all of the numeric data types—the same + 
that works with int values also works with float, for example. The 
same operator is used, but the code generated is clearly different, 
since integers and floating-point numbers are represented 
differently in memory. In other words, operators such as + are 
already overloaded, even in regular C. C++ simply extends this 
idea to allow user-defined versions of the existing operators. 


To define an operator, you define a function that has as its name 
the keyword operator followed by the operator symbol. (So, for 
example, operator+ names a new version of the + operator.) All op- 
erator functions are by definition overloaded: They use an opera- 
tor that already has a meaning in C, but they redefine it for use 
with a new data type. The + operator, for example, already has the 
capability to add two values of any of the standard numeric types 
(int, float, double, and so on.) 


Now we can add a + operator to the String class. This operator 
will concatenate two string objects (as in BASIC) returning the 
result as a string object with the appropriate length and contents. 
Since concatenating is “adding together,” the + symbol is the ap- 
propriate one to use. The BASIC lobby often criticizes C for not 
having such natural string operations. With C++, you can go far 
beyond the built-in BASIC string facilities. 


The file XSTRING.CPP, available on your distribution disks, has 
the following additions to STRING.CPP to provide a simple 
operator +. 


//XSTRING,.CPP--Example from Chapter 5 of Getting Started */ 
// version of STRING.CPP with overloaded operator + 


#include <iostream.h> 
#include <string.h> 


Turbo C++ Getting Started 


Chapter 5, A C++ primer 


class String { 
char *char ptr; // pointer to string contents 
int length; // length of string in characters 
public; 
// three different constructors 
String(char *text); // constructor using existing string 
String(int size = 80); // creates default empty string 
String(String& Other String); // for assignment from another 
// object of this class 
~String() {delete char ptr;}; // inline destructor 
int Get_len (void); 
String& operatort+ (String& Arg); 
void Show (void); 


hi 


String::String (char *text) 

{ 
length = strlen(text); // get length of text 
char ptr = new char{length + 1]; 
strcpy(char ptr, text); 

hi 


String::String (int size) 

{ 
length = size; 
char ptr = new char[length+l]; 
*char ptr = '\0'; 

h; 


String::String (Strings Other String) 

{ 
length = Other String. length; // length of other string 
char ptr = new char [length + 1]; // allocate the memory 
strcepy (char ptr, Other String.char ptr); // copy the text 

MF 


Stringé String::operatort+ (Stringé& Arg) 
{ 
length += Arg.length; 
char * NewText = new char[lengtht1l]; 
strcpy(Newlext, char ptr); 
strcat (NewIlext, Arg.char ptr); 
delete char ptr; 
char ptr = NewText; 
return *this; 


int String::Get_len (void) 
return (length); 


)3 
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To see this display from the 
IDE, press Alt-F5 or Window |! 


User. 


this is discussed in greater 


detail in the Programmers 
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void String: :Show (void) 
{ 
cout << char ptr << "\n"; 


hi; 
main () // test the functions 
{ 

String AString ("The Quick Brown fox"); 

AString.Show() ; 


String BString(" jumps over Bill"); 
String CString; 
CString = AString + BString; 
CString .Show(); 

} 


When you run the program, CString is assigned the concatenation 
of the two strings AString and BString. So CString.Show() displays 


The Quick Brown Fox jumps over Bill 


The overloaded + takes only one explicit argument, so you may 
wonder how it manages to concatenate two strings. Well, the 
compiler treats the expression AString + BString as 


AString. (operator +(BString} ) 


so the + operator does access two string objects. The first is the 
String object currently being referenced, and the other is a second 
string object. The operator function adds the lengths of the two 
strings together, then uses the streat library function to combine 
the contents of the two strings, which is then returned. This re- 
markable trick makes use of a “hidden” pointer known as this. 
What is this? 


Every call by a member function sets up a pointer to the object 
upon which the call is acting. This pointer can be referred via the 
keyword this (also known as “self” or rather “pointer-to-self” in 
OOP parlance), allowing functions to access the actual object. 
Now this is of type “pointer to String”, so the return value must 
be *this, the actual current object, is exactly what is needed. Note, 
too, that individual members of the object involved in a function 
call can be referenced via the expression this->member. A further 
point to watch: this is available only to member functions, not to 
friend functions. 


There are some restrictions when overloading operators: 


m C++ can’t distinguish between the prefix and postfix versions of 
++ and —-—. 
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Friend functions 


The position of the decla- 
ration doesn't matter. 
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u The operator you wish to define must already exist in the 
language. For example, you can’t define the operator #. 


w You can’t overload the following operators: 
ee: ee 
m Overloaded operators keep their original precedence. 


u If @ stands for any unary operator, the expressions @x and x@ 
may be interpreted as either x.operator@() or as operator@(x). 
If both forms have been declared, the compiler will try to 
resolve the ambiguity by matching the arguments. Similarly, 
with an overloaded binary operator, @, x@y could mean either 
x.operator@(y) or operator@(x,y), and the compiler needs to 
look at the arguments if both forms have been defined. You saw 
an example of a binary operator in the string version of +, 
where AString + BString was interpreted as AString. (operator 
+(BString)). 


Normally, access to the private members of a class is restricted to 
member functions of that class. Occasionally it may be necessary 
to give outside functions access to the class’s private data. The 
friend declaration within a class declaration lets you specify 
outside functions (or even outside classes) that will be granted ac- 
cess to the declared class’s private members. You'll sometimes see 
an overloaded operator declared as a friend, but generally speak- 
ing friend functions are to be used sparingly—if their need 
persists in your project, it is often a sign that your class hierarchy 
needs revamping. 


But, suppose that there is a fancy formatted printing function 
called Fancy_Print that you want to have access to the contents of 
your objects of class String. You can add the following line to the 
list of member function declarations: 


class String { 


friend void Fancy Print (String& AString); 


In this admittedly artificial example, the Fancy_Print function can 
access the members char_ptr and length of objects of the String 
class. That is, if AString is a string object, Fancy_Print can access 
AString.char Ptr and AString. length. 
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The C++ streams 


libraries 


This section ts intended 


merely to whet your appetite 


and point you in the right 


direction. We encourage you 


to study the examples in 


Chapter 3, “C++ streams,” in 
the Programmers Guide and 
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experiment on your own. 


If the Fancy_Print function is a member of another class (for ex- 
ample, the class Format), use the scope resolution operator in the 
friend declaration: 


friend void Format::Fancy Print (String& AString); 


You can also make a whole class the friend of the declared class, 
by using the word class in the declaration: 


friend class Format; 


Now any member function of the Format class can access the 
private members of the String class. Note that in C++, as in life, 
friendship is not transitive: if X is a friend of Y, and Y is a friend of 
Z, it does not follow that X is a friend of Z. 


The friend declaration should be used only when it is really neces- 
sary; when without it you would have to have a convoluted class 
hierarchy. By its nature, the friend declaration diminishes 
encapsulation and modularity. In particular, if you find yourself 
wanting to make a whole class the friend of another class, 
consider instead the possibility of deriving a common derived 
class and using it to access the needed members. 


While all the stdio library I/O functions (such as printf and scanf) 
are still available, C++ also provides a group of classes and func- 
tions for I/O defined in the iostreams library. To access these 
your program must have the directive #include <iostream.h>, as 
you may have noticed in some of our examples. 


There are many advantages in using iostreams rather than stdio. 
The syntax is simpler, more elegant, and more intuitive. The C++ 
stream mechanism is also more efficient and flexible. Formatting 
output, for example, is simplified by extensive use of overloading. 
The same operator can be used to output both predefined and 
user-defined data types, avoiding the complexities of the printf 
argument list. 


Starting with the stream as an abstraction for modeling any flow 
of data from a source (or producer) to a sink (or consumer), 
iostream provides a rich hierarchy of classes for handling 
buffered and unbuffered I/O for files and devices. 


Turbo C++ also supports the older (version 1.x) C++ stream 
library to assist programmers during the transition to the new 
iostream library of C++ release 2.0. If you have any C++ code that 
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uses the obsolete stream classes, you can still maintain and run it 
with Turbo C++. However, given a choice, you should convert to 
the more efficient iostream and avoid stream when writing new 
code. Chapter 3, “C++ streams,” in the Programmer’s Guide 
explains the differences between the stream and iostream 
libraries, and provides some hints on conversion. See also 
OLDSTR.DOC on your distribution disks. 


In this section we cover only the simpler classes in iostream. For a 
more detailed account, you should read Chapter 3, “C++ 
streams,” in the Programmer’s Guide. You can also browse through 
iostream.h on your distribution disks to see the many classes 
defined there and how they are derived using both single and 
multiple inheritance. 


standard |/O C++ provides four predefined stream objects defined as follows: 


acin standard input, usually the keyboard, corre- 
sponding to stdin in C 

m cout standard output, usually the screen, correspond- 
ing to stdout in C 

mcerr standard error output, usually the screen, corre- 
sponding to stderr in C 

a clog a fully-buffered version of cerr (no C equivalent) 


You can redirect these standard streams from and to other devices 
and files. (In C, you can redirect only stdin and stdout.) You have 
already seen the most common of these, cin and cout, in some of 
the examples in this chapter. 


A simplified view of the iostream hierarchy, from primitive to 
specialized, is as follows: 


a streambuf provides methods for memory buffers 

gios handles stream state variables and 
errors 

a istream handles formatted and unformatted 
character conversions from a streambuf 

# ostream handles formatted and unformatted 
character conversions to a streambuf © 

mw iostream combines istream and ostream to 


handle bidirectional operations ona 
single stream 
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<< used with streams is called 


the insertion or put fo 


operator, while >> is called 
the extraction or get from 


operator. 


This program simply stores 
each Input character in the 
variable ch and then outputs 
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the value of ch to the 
screen. 


mistream_withassign provides constructors and assignment 
operators for the cin stream. 


mostream_withassign provides constructors and assignment 
operators for the cout, cerr and clog 
streams. 


The istream class includes overloaded definitions for the >> oper- 
ator for the standard types [int, long, double, float, char, and 
char* (string)]. Thus the statement cin >> x; calls the appropriate 
>> operator function for the istream cin defined in iostream.h and 
uses it to direct this input stream into the memory location repre- 
sented by the variable x. Similarly, the ostream class has over- 
loaded definitions for the << operator, which allows the statement 
cout << x; to send the value of x to ostream cout for output. 


These operator functions return a reference to the appropriate 
stream class type (e.g., ostream&) in addition to moving the data. 
This allows you to chain several of these operators together to 
output or input sequences of characters: 


int 1=0, x=243; double d=0; 
cout << "The value of x is " << x << '\n!; 
cin >> i >> d; // key an int, space, then a double 


The second line would display “The value of x is 243” followed by 
a new line. The next statement would ignore whitespace, read and 
convert the keyed characters to an integer and place it in 7, ignore 
following whitespace, read and convert the next keyed characters 
to a double and place it in d. 


The following program simply copies cin to cout. In the absence 
of redirection, it copies your keyboard input to the screen: 


// COPYKBD.CPP Copies keyboard input to screen 
#include <iostream.h> 


main() 
{ 
Ghar ch; 
while (cin >> ch) 
cout << ch; 


Note how you can test (cin >> ch) as a normal Boolean expression. 
This useful trick is made possible by definitions in the class ios. 
Briefly, an expression such as (cout) or (cin >> ch) is cast as a 
pointer, the value of which depends on the error state of the 
stream. A null pointer (tested as false) indicates an error in the 
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Formatted output 
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stream, while a non-null pointer (tested as true) means no errors. 
You can also reverse the test using !, so that (/cout) is true for an 
error in the cout stream and false if all is well: 


if (!cout) errmsg("Output error!"); 


Simple I/O in C++ is efficient because only minimal conversion is 
done according to the data type involved. For integers, conversion 
is the same as the default for printf. The statements 


int 1=5; cout << i; 
and 

int i=5; printt("sd")i); 
give the same result. 


Formatting is determined by a set of format state flags enumera- 
ted in ios. These determine, for each active stream, the conversion 
base (decimal, octal, and hexadecimal), padding left or right, the 
floating-point format (scientific or fixed), and whether whitespace 
is to be skipped on input. Other parameters you can vary include 
field width (for output) and the character used for padding. These 
flags can be tested, set, and cleared by various member functions. 
The following snippet shows how the functions ios::width and 
ios::fill work: 


int previous width, i = 87; 
previous width = cout.width(7); // set field width to 7 

// and save previous width 
cout £1119 *"}¢ // set fill character to * 
cout << i << '\n!; // display *****87 <newline> 
// after << the width is cleared to 0 
// previous width may have been set without a subsequent << 
// so you may want to restore it with the following line. 
cout. .width (previous width); 


Setting width to zero (the default) means that the display will take 
as many screen positions as needed. If the given width is insuffic- 
ient for the correct representation, a width of zero is assumed 
(that is, there is no truncation). Default padding gives right 
justification (left padding) for all types. 


setf and unsetf are two general functions for setting and clearing 
format flags: 


cout.setf(ios::left, ios::adjustfield); 
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This sets left padding. The first argument uses enumerated mne- 
monics for the various bit positions (possibly combined using & 
and |) and the second argument is the target field in the format 
state. unsetf works the same way but clears the selected bits. 
(More on these in Chapter 3, “C++ streams,” in the Programmer’s 
Guide.) 


Manipulators 


A rather more elegant way of setting the format flags (and per- 
forming other stream chores) uses special mechanisms known as 
manipulators. Like the << and >> operators, manipulators can be 
embedded in a chain of stream operations: 


cout << setw(7) << dec << i << setw(6) << oct << jj 
Without manipulators, this would take six separate statements. 


The parameterized manipulator setw takes a single int argument to 
set the field width. 


The non-parameterized manipulators, such as dec, oct, and hex, 
set the conversion base to decimal, octal, and hexadecimal. In the 
above example, int i would display in decimal on a field of width 
7; int j would display in octal on a field of width 6. 


Other simple parameterized manipulators include setbase, setfill, 
setprecision, setiosflags, and resetiosflags. To use any of the 
parameterized manipulators, your program must have include 
both of these header files: iomanip.h and iostream.h. Non- 
parameterized manipulators do not require iomanip.h. 


Useful non-parameterized manipulators include: 


ws (whitespace extractor): istream >> ws; will discard any 
whitespace in istream. 


endl (endline and flush): ostream << endl; will insert a newline in 
ostream, then flush the ostream. 


ends (end string with null): ostream << ends; will append a null to 
ostream. 


flush (flush output stream): ostream << flush; flushes the ostream. 


puf, write, and get 


Two general output functions are worthy of mention: put and 
write, declared in ostream as follows: 
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ostream& ostream::put (char ch); 
// send ch to ostream 


ostream&é ostream::write(const char* buff, int n); 
// send n characters from buff to ostream; watch the size of n! 


put and write let you output unformatted binary data to an 
ostream object. put outputs a single character, while write can 
send any number of characters from the indicated buffer. write is 
useful when you want to output raw data that may include nulls. 
(Note that writing binary data requires that the file be opened in 
binary mode.) The normal string extractor would not work since 
it terminates on a null. 


The input version of put is called get: 


char ch; 
cin.get (ch); 
// grab next char from cin whether whitespace or not 


Another version of get lets you grab any number of raw, binary 
characters from an istream, up to a designated maximum, and 
place them in a designated buffer (as with write, files must be 
opened in binary mode): 


istreamé istream::get(char *buf, int max, int term='\n’); 
// read up to max chars from istream, and place them in buf. Stop if 
// term char is read. 


You can set ferm to a specific terminating character (the default is 
the newline character), at which get will stop if reached before 
max characters have been transferred to buf. 


Disk |/O The iostream library includes many classes derived from 
streambuf, ostream, and istream, thereby allowing a wide choice 
of file I/O methods. The filebuf class, for example, supports I/O 
through file descriptors with member functions for opening, 
closing, and seeking. Contrast this with the class stdiobuf that 
supports I/O via stdio FILE structures, allowing some 
compatibility when you need to mix C and C++ code. 


The most generally useful classes for the beginner are ifstream 
(derived from istream), ofstream (derived from ostream), and 
fstream (derived from iostream). These all support formatted file 
I/O using filebuf objects. Here’s a simple example that copies an 
existing disk file to another specified file: 


This code is available as /* DCOPY.CPP -- Example from Chapter 5 of Getting Started */ 
DCOPY.CPP. 
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DCOPY source-file destination-file * 
copies existing source-file to destination-file * 
If latter exists, it is overwritten; if it does not * 
exist, DCOPY will create it if possible * 


*/ 


#include <iostream.h> 
#include <process.h> // for exit({). 
#include <fstream.h> // for ifstream, ofstream 


main(int argc, char* argv[]) // access command-line arguments 


{ 


char ch; 
if (argc != 3) // test number of arguments 
{ 
cerr << "USAGE: dcopy filel file2\n"; 
exit(-1); 


} 


ifstream source; // declare input and output streams 
ofstream dest; 


source.open(argv[1],ios::nocreate); // source file must be there 
if (!source) 
{ 
cerr << "Cannot open source file “ << argv{1] << 
" for input\n"; 
exit(-1); 
} 
dest .open(argv{2]); // dest file will be created if not found 
// or cleared/overwritten if found 
if (dest) 
{ 
cerr << "Cannot open destination file " << argv[2] < 
" for output\n"; 
exit (1); 


while (dest && source.get(ch)) dest.put (ch); 
cout << "DCOPY completed\n"; 


source.close(); // close both streams 
dest .close(); 


Note first that #include <fstream> also pulls in iostream.h. DCOPY 
uses the standard method of accessing command-line arguments 
to check whether the user specified the two files involved. When 
this argument list is used with the main function, the argument 
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argc contains the number of command-line arguments (including 
the name of the program itself), and the strings argv[1] and argu[2] 
contain the two file names entered. A typical command-line 
invocation of this program would be 


dcopy letter.spr letter.bak 
To see how DCOPY works, examine the following lines: 


ifstream source; // declare an input stream (ifstream object) 


open.source(argv(1],ios::nocreate); // source file must be there 
The declaration invokes a constructor of ifstream (the class for 
handling input file streams) to create a stream object called source. 
Before we can make use of source, we must create a file buffer and 
associate the stream and buffer with a real, physical file. Both 
tasks are performed by the member function open in Ifstream. 
The open function needs a file name string and, optionally, one or 
two other arguments to specify the mode and protection rights. 
The file name here is given as argv[1], namely, the source file 
supplied in the command line. 


A neater alternative to the above declaration is: 


ifstream source(argv[1],ios::nocreate); // source file must be there 
// this creates source and opens the file as well 


The mode argument los::nocreate tells open not to create a file if 
the named file is not found. For DCOPY, we clearly want open to 
fail if the named source file is not on the disk. Later, you'll see the 
other mode arguments available. If the file argv[1] cannot be 
opened for any reason (usually because the file is not found), the 
value of source is effectively set to zero (false), so that (!source) 
tests true, giving us an error message, then exiting. 


In fact, we could determine the possible reason for the failure to 
open the source file by examining the error bits set in the stream 
state. The member functions eof, fall, and bad test various error 
bits and return true if they are set. Alternatively, rdstate returns 
the error state in an Int, and you can then test which bits are set. 
The eof (end of file) is not really an error per se, but it needs to be 
tested and acted upon since a stream cannot be usefully accessed 
beyond its final character. Note that once a stream is in an error 
state (including eof), no further I/O is permitted. The function 
clear is provided for clearing some or all error bits, allowing you 
to resume after clearing a nonfatal situation. 
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When C fests (x && y), if will 
not bother fo test y if x proves 
false. Since dest is less likely 
to “fail” than source.get(ch), 
you might consider reversing 


the entries. 


Back in DCOPY.CPP, if all is well with the source file, we then try 
to open the destination file with the ofstream object, dest. With 
output files, the default situation is that a file will be created if it 
does not exist; if it exists it will be cleared and recreated as an 
empty file. You can modify this behavior by adding a second 
argument, mode, to the declaration of dest. For example: 


ofstream dest (argv[2],ios::app|ios::nocreate) ; 


will try to open dest in append mode, failing if dest is not found. In 
append mode, the data in the source file would be added to the 
end of dest, leaving the previous contents undisturbed. Other 
mode flags enumerated in class ios (note the scope operator in 
los::app), are ate (seek to end of file); in (open for input, used 
with fstreams, since they can be opened for both input and 
output); out (open for output, also used with fstreams); trunc 
(discard contents if file exists); noreplace (fail if file exists). 


Once both files have been opened, the actual copying is achieved 
in typically condensed C fashion. Consider the Boolean expres- 
sion tested by the while loop: 


(dest && source.get (ch) ) 


We have seen that dest will test true until an error occurs. 
Similarly the call source.get(ch) will test true until either a reading 
error occurs or until the end of the file is reached. In the absence 
of “hard” errors, then, the loop gets characters from source and 
puts them in dest until an end of file situation makes source false. 


There are many more file I/O features in the iostream library. 
And iostream can also help you with in-memory formatting, 
where your streams are in RAM. Special classes, such as 
strstreambuf, are provided for in-memory stream manipulation. 


|/O for user-defined data types 
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A real benefit with C++ streams is the ease with which you can 
overload >> and << to handle I/O for your own personal data 
types. Consider a simple data structure that you may have 
declared: 


struct emp { 
char *name; 
int dept; 
long sales; 
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}; 


To overload << to output objects of type emp, you need the 
following definition: 


ostream& operator << (ostream& str, empé e} 

{ 

str << setw(25) << e.name << "; Department " << setw(6) << e.dept << 
<< tab << " Sales $" << e.sales << '\n'; 

return Str; 


Note that the operator-function << must return ostream&, a 
reference to ostream, so that you can chain your new << just like 
the predefined insertion operator. You can now output objects of 
type emp as follows: 


#include <iostream.h> 
#include <iomanip.h> // don't forget this! 
emp jones = {"S, Jones", 25, 1000}; 
cout << jones; 
giving the display 
S. Jones: Department 25 Sales $1000 


Did you spot the manipulator tab in the << definition? This is not 
a standard manipulator—but a user-defined one: 


ostream&é tab(ostreamé& str) { 
return str << '\t!; 
} 


This, of course, is trivial, but nevertheless makes for more legible 
code. 


An input routine for emp can be similarly devised by overloading 
>>. This is left as an exercise for the reader. 


Where to now’? 


A suggestion for your first C++ project is to take the FIGURES 
module shown on page 163 (you have it on disk) and extend it. 
Points, circles, and arcs are by no means enough. Create objects 
for lines, rectangles, and squares. When you're feeling more 
ambitious, create a pie-chart object using a linked list of indivi- 
dual pie-slice figures. 
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One more subtle challenge is to implement classes to handle 
relative position. A relative position is an offset from some base 
point, expressed as a positive or negative difference. A point at 
relative coordinates —17,42 is 17 pixels to the left of the base point, 
and 42 pixels down from that base point. Relative positions are 
necessary to combine figures effectively into single larger figures, 
since multiple-figure combinations cannot always be tied together 
at each figure’s anchor point. Better to define an RX and RY field 
in addition to anchor point X,Y, and have the final position of the 
object onscreen be the sum of its anchor point and relative 
coordinates. 


Once you feel comfortable with C++, start building its concepts 
into your everyday programming chores. Take some of your more 
useful existing utilities and rethink them in C++ terms. Try to see 
the classes in your hodgepodge of function libraries—then rewrite 
the functions in class form. You'll find that libraries of classes are 
much easier to reuse in future projects. Very little of your initial 
investment in programming effort will ever be wasted. You will 
rarely have to rewrite a class from scratch. If it will serve as is, use 
it. If it lacks something, extend it. But if it works well, there’s no 
reason to throw away any of what's there. 


Conclusion 


C++ is a direct response to the complexity of modern applications, 
complexity that has often made many programmers throw up 
their hands in despair. Inheritance and encapsulation are extreme- 
ly effective means for managing complexity. C++ imposes a 
rational order on software structures that, like a taxonomy chart, 
imposes order without imposing limits. 


Add to that the promise of the extensibility and reusability of 
existing code, and you not only have a toolkit—you have tools to 
build new tools! 
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This chapter is a concise, 
hanas-on tutorial for C++. 


Important! 
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Hands-on C++ 


In order to give you a sense of how C++ looks and how to ac- 
complish tasks in C++, this chapter moves quickly through a large 
number of concepts with a minimum of verbiage. It is intended to 
be used as you work at your computer; you can load and run each 
of these programs (which are in your EXAMPLES subdirectory, 
along with any header and other files that you’ll need). If you 
want a more in-depth treatment of C++, especially of the concepts 
underlying object-oriented programming, read Chapter 5, “A C++ 
primer.” You might also want to refer to Chapter 1, “The Turbo 
C++ language standard,” in the Programmer's Guide for precise 
details about the syntax and use of C++. 


In this chapter, we assume that you are familiar with the C lan- 
guage, and that you know how to compile, link, and execute a 
source program with Turbo C++. We start with simple examples 
that grow in complexity so that new concepts will stand out. It is 
reasonable that such examples will not be bulletproof (in other 
words, they don’t check for memory failure and so on). This 
chapter is not a treatise on data structures or professional pro- 
gramming techniques; instead, it is a gentle introduction to a 
complicated language. 


This chapter is divided into two sections. The first section pro- 
vides C++ alternatives to C programming knowledge and habits 
you might have. The second section provides a swift introduction 
to the kernel of C++: Object-oriented programming using classes 
and inheritance. 


195 


A better C: Making the transition from C 


When referring to line 
numbers, weve counted 
blank lines. 


Program | 


Source 


Output 
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Although knowing C is helpful to learning C++, sometimes that 
knowledge can get in the way, particularly in the areas that aren’t 
specifically object-oriented programming, yet where C++ does 
things differently from C. For that reason, this section shows how 
to accomplish in C++ many of the same kinds of actions you 
would perform in C: writing text to the screen, commenting your 
code, creating and using constants, working with stream I/O and 
inline functions, and so on. 


// exl.cpp: A First Glance 
// from Chapter 6 of Getting Started 
#include <iostream.h> 


main() 


{ 
cout << "Frankly, my dear...\n"; 
cout << "C++ is a better C.\n"; 


Frankly, my dear... 
C++ is a better C, 


Note the new comment syntax in the first line of this program. All 
characters from the first occurrence of double slashes to the end of 
a line are considered a comment, although you can still use the 
traditional /*...*/ style. File names which have a .CPP extension are 
assumed to be C++ files (or you could use the command-line com- 
piler option —P). 


The third line includes the standard header file iostream.h, which 
replaces much of the functionality of stdio.h. cout is an output 
stream, and is used to send characters to standard output (as 
stdout does in C). The << operator (pronounced “put to”) sends 
the data on its right to the stream on its left. The context of the << 
operator here distinguishes it from the arithmetic shift-left opera- 
tor, which uses the same symbol. (Such multiple use of operators 
and functions is quite common in C++ and is called overloading.) 
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Program 2 


Source 


Sample execution 


Program 3 


Source 


In an important change from 
C, declarations can appear 
anywhere a statement can. 
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// ex2.cpp: An interactive example 
// from Chapter 6 of Getting Started 
#include <iostream.h> 


main() 

{ 
char name[16]; 
int age; 


cout << "Enter your name: "; 
cin >> name; 

cout << "Enter your age: "; 
cin >> age; 


if (age < 21) 

cout << "You young whippersnapper, " << name << "!\n"; 
else if (age < 40) 

cout << name << ", you're still in your prime!\n"; 
else if (age < 60) 

cout << "You're over the hill, " << name << "!\n"; 
else if (age < 80) 

cout << "I bow to your wisdom, " << name << "!\n"; 
else 

cout << "Are you really " << age << ", " << name << "2\n"; 

} 


Enter your name: Don 
Enter your age: 40 
You're over the hill, Don! 


cin is an input stream connected to standard input. It can correct- 
ly process all the standard data types. You may have noticed in C 
that printing a prompt without a newline character to stdout re- 
quired a call to fflush(stdout) in order for the prompt to appear. In 
C++, whenever cin is used it flushes, cout automatically (you can 
turn this automatic flushing off if it’s on by default). 


// ex3.cpp: Inline Functions 
// from Chapter 6 of Getting Started 
#finclude <iostream.h> 


const float Pi = 3.1415926; 
inline float area(const float r) {return Pi * r * r;} 


main () 
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float radius; 


cout << "Enter the radius of a circle: "; 

cin >> radius; 

cout << "The area is " << area(radius) << "\n"; 
} 


Sample execution Enter the radius of a circle: 3 
The area is 28.274334 


A constant identifier behaves like a normal variable (that is, its 

scope is the block that defined it, and it is subject to type check- 
ing) except that it cannot appear on the left-hand side of an as- 

signment statement (or anywhere an lvalue is required). Using 

#define is almost obsolete in C++. 


The keyword inline tells the compiler to insert code directly 
whenever possible, in order to avoid the overhead of a function 
call. In all other ways (scope, etc.) an inline function behaves like 
a normal function. Its use is recommended over #defined macros 
(except, of course, where you depend on the macro-substitution 
tricks of the preprocessor). This feature is intended for simple, 
one-line functions. 


Program 4 


Source // ex4.cpp: Default arguments and Pass-by-reference 
// from Chapter 6 of Getting Started 
#include <iostream.h> 
#include <ctype.h> 


int get_word(char *, int & int start = 0); 


main () 
{ 
int word len; 
char *s = ". These words will be printed one-per-line "; 


int word idx = get word(s,word len); // line 13 
while (word len > 0) 
cout.write(stword idx, word len); 
cout-<< “\n"; 
//cout << form("%.*s\n",word len,stword idx); 
word idx = get_word(s,word len,word idx+word len); 


ifs good programming style int get word(char *s, int& size, int start) 


fo make null loop bodies 
stand out. 
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Output 


One exciting feature of C++ 
is the default argument. 


Object support 


// Skip initial whitespace 

for (int 1 = start; isspace(s{i]); ++i); 

int start of word = i; 

// Traverse word 

while (s[{i] != '\0! && !isspace(s[i]})) 
+a 

size = i - start of word; 

return start of word; 


These 

words 

will 

be 

printed 
one-per-line 


The prototype for the function get_word in the sixth line has two 
special features. The second argument is declared to be a reference 
parameter. This means that the value of that argument will be 
modified in the calling program (this is equivalent to var parame- 
ters in Pascal, and is accomplished through pointers in C). By this 
means, the variable word_len is updated in main, and yet we can 
still return another useful value with the function get_word. 


The third argument is a default argument. This means that it can 
be omitted (as in line 13), in which case the value of 0 is passed 
automatically. Note that the default value need only be specified 
in the first mention of the function. Only the trailing arguments of 
a function can supply default values. 
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The world is made up of things that both possess attributes and 
exhibit behavior. C++ provides a model for this by extending the 
notion of a structure to contain functions as well as data members. 
This way an object’s complete identity is expressed through a 
single language construct. The notion of object-oriented support 
then is more than a notational convenience—it is a tool of 
thought. 
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Program 5 


You ‘ll need to compile 
DEF.CPP to an OBJ file, then 

_ link it in with either EX6.CPP or 
EX7.CPP (or load EX5.PRJ). 

You might also want to 
compile it with Debug Info 
checked so you can step 
through and watch the 
program flow. 


In other object-oriented 
languages, classes are offen 
called objects, and member 

functions are called 
methods. 
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Suppose we want to have an online dictionary. A dictionary is 


made up of definitions for words. We will first model the notion 
of a definition. | 


// def.h: A word definition class 
// from Chapter 6 of Getting Started 
#include <string.h> 


const int Maxmeans = 5; 


class Definition 

{ 
char *word; 
char *meanings[Maxmeans]; 
int nmeanings; 


// Word being defined 
// Various meanings of this word 


public: 
void put_word(char *); 
char *get_word(char *s) {return strcpy(s,word);}; 
void add meaning(char *); 
char *get_meaning(int, char *); 


// line 15 


bj 


In traditional C style, we put definitions in an include file. The 
keyword class introduces the object description. By default, 
members of a class are private (though you can explicitly use the 
keyword private), so in this case the fields in lines 9 through 11 
can only be accessed by functions of the class. (In C++, class 
functions are called member functions.) To make these functions 
available as a user interface, they are preceded by the keyword 
public. Note that the inline keyword is not required inside class 
definitions (line 15). 


The implementation is usually kept in a separate file: 


// def.cpp: Implementation of the Definition class 
// from Chapter 6 of Getting Started 

#include <string.h> 

#include “def.h" 


void Definition: :put_word(char *s) 
{ 
word = new char[strlen(s)+1]; 
strcpy (word, Ss); 
nmeanings = 0; 


void Definition::add meaning(char *s) 
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Source 


Output 
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if (nmeanings < Maxmeans) 


meanings [nmeanings] = new char[strlen(s)+1]; 
strcpy (meanings [nmeanings+t+],s); 


char * Definition::get_meaning(int level, char *s) 
{ 
if (0 <= level && level < nmeanings) 
return strcpy(s,meanings([level]); 
else 
return 0; // line 27 
} 


The scope resolution operator (::) informs the compiler that we are 
defining member functions for the Definition class (it’s good 
practice to capitalize the first letter of a class to avoid name 
conflicts with library functions). The keyword new in line 8 is a 
replacement for the dynamic memory allocation function malloc. 
In C++, by convention, zero is used instead of NULL for pointers 
(line 27). Although we didn’t do so here, it is advisable to verify 
that new returns a non-zero value. 


// ex5.cpp: Using the Definition class 
// from Chapter 6 of Getting Started 
#include <iostream.h> 

#include “def.h" 


main () 

| 
Definition d; // Declare a Definition object 
char s[81]; 


// Assign the meanings 
d.put_word("class"); 
d.add meaning("a body of students meeting together to \ 
study the same subject"); 
d.add meaning("a group sharing the same economic status"); 
d.add meaning("a group, set or kind sharing the same attributes") ; 


// Print them 
cout << d.get_word(s) << ":\n\n"; 
for (int i = 0; d.get meaning(i,s) != 0; ++1) 
cout <<: a41L << Se ® << os <n" 
} 


class: 


1: a body of students meeting together to study the same subject 
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2: a group sharing the same economic status 
3: a group, set, or kind sharing the same attributes 


Program 6 
We can now define a dictionary as a collection of definitions. 
sical ell Mae ahi // diction.h: The Dictionary class 
DEF.OBJ with EX6.CPP. From A rey Ob SSeE ana ehertee 
the IDE, use the EX6.PRJ noes wre? 
project file. const int Maxwords = 100; 


202 


class Dictionary 

{ 
Definition *words; // An array of definitions; line 9 
int nwords; 


int find word(char *); // line 12 


public: 
// The constructor is on the next line 
Dictionary(int n = Maxwords) 
{nwords = 0; words = new Definition[n];}; 
~Dictionary() {delete words;}; 
void add def(char *s, char **def); // The destructor; line 17 
int: get: def(char*,; char -**); 


Me 


The function find_word on line 12 is for internal use only by the 
Dictionary class and so is kept private. A function with the same 
name as the class is called a constructor (line 16). It is called once 
whenever an object is declared. It is used to perform initializa- 
tions; here we are dynamically allocating space for an array of 
definitions. A destructor (line 17) is called whenever an object goes 
out of scope (in this case, the delete operator will free the memory 
previously allocated by the constructor). In order to have an array 
of member objects (line 9), the included class must either have a 
constructor with no arguments or no constructor at all (the 
Definition class has none). 


// diction.cpp: Implementation of the Dictionary class 
// from Chapter 6 of Getting Started 
#include "diction.h" 


int Dictionary::find word(char *s) 
{ 

char word[81]; 

for {int i = 0; i < nwords; ++i) 
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Source 
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if (stricmp({words[i].get_word(word),s) == 0) 
return ij 


return -l; 


void Dictionary::add def(char *word, char **def) 
{ 
if (nwords < Maxwords) 
{ 
words [nwords}.put_ word (word) ; 
while (*def != 0) 
words [nwords].add meaning (*deft+) ; 
++nwords; 


} 


int Dictionary::get def(char *word, char **def) 
{ 
char meaning[81]; 
int nw = 0; 
int word idx = find word(word); 
if (word idx >= 0) 
{ 
while (words[word idx].get_meaning(nw,meaning) != 0) 
{ 
def[nw] = new char[strlen(meaning) +1]; 
strepy (def (nwt+],meaning) ; 
} 
def{nw] = 0; 


return nw; 


} 


We can now use the Dictionary class without any reference to the 


Definition class (the output is the same as in the previous 
example). 


// ex6.cpp: Using the Dictionary class 
// from Chapter 6 of Getting Started 
#include <iostream.h> 

#include “diction.h" 


main {) 
{ 
Dictionary d(5); 
char *word = "class"; 
char *indef[{4] = 
{"a body of students meeting together to study the same", 
“subject a group sharing the same economic status", 
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“a group, set or kind sharing the same attributes", 
0}; 
char *outdef[4]; 


d.add def (word, indef) ; 
cout << word << ":\n\n"; 
int ndef = d.get def (word, outdef) ; 
for (int i = 0; i < ndef; ++i) 
cout << itl << "3; " << outdef[i] << "\n"; 
} 


In the Dictionary implementation, we specifically called the Defi- 
nition member functions. Sometimes it is desirable to allow 
certain functions or even an entire class to have access to the pri- 
vate members of another. We could declare the Dictionary class to 
be a friend to the Definition class (line 18): 


Build LIST.OBJ with EX7.C PP // def2.h: A word definition class 


// from Chapter 6 of Getting Started 
#include <string.h> 


const int Maxmeans = 5; 


class Definition 
char *word; // Word being defined 
char *meanings [Maxmeans]; // Various meanings of this word 
int nmeanings; 


public: 
void put word(char *); 
char *get word(char *s) {return strcpy(s,word) ;}; 
void add meaning(char *); 
char *get_meaning(int, char *); 
friend class Dictionary; // line 18 


hi 


The implementation of find_word could then access Definition 
members directly (line 5 in the following code): 


int Dictionary::find word(char *s) 
{ 
char word[81]; 
for (int i = 0; i < nwords; ++i) 
lf (stricmp(words[i].word),s) == 0) 
return 1; 


return -1; 
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Program 7 


To try these out, build 
LIST. OBJ and EX7. CPP, or use 
EX7.PRJ. 
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One of the key features of object-oriented programming is inheri- 
tance. A new class can inherit the data and member functions of 
an existing (“base”) class (the new class is said to be derived from 
the base class). In this program, we define List, a base class for 
processing a list of integers, then derive Stack, a class to handle a 
stack (which is a special kind of list). First, we create the header 
file: 


// list.h: A Integer List Class 
// from Chapter 6 of Getting Started 
const int Max elem = 10; 


class List 
{ 
int. Flist; // An array of integers 
int nmax; // The dimension of the array 
int nelem; // The number of elements 
public: 


List (int n = Max elem) {list = new int[n]; nmax = n; nelem = 07}; 
~List() {delete list;}; 

int put elem(int, int); 

int get elem(int&, int); 

void setn(int n) {nelem = n;}; 

int getn() {return nelem;}; 

void incn({) {if (nelem < nmax) t+ttnelem;}; 

int getmax() {return nmax;}; 

void print (); 


iy 
Then we create the source code: 


// list.cpp: Implementation of the List Class 
// from Chapter 6 of Getting Started 

#include <iostream.h> 

#include “list.h" 


int List::put elem(int elem, int pos) 
{ 

if (Q <= pos && pos < nmax) 

{ 


list[pos] = elem; // Put an element into the list 
return 0; 

else 
return -1; // Non-zero means error 
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int List::get_elem(int& elem, int pos) 
{ 
if (0 <= pos && pos < nmax) 


{ 


elem = list [pos]; // Retrieve a list element 
return 0; 

} 

else 
return -1; // non-zero means error 


void List::print () 
{ 
for (int i = 0; i < nelem; ++i) 
cout << list[i] << "\n"; 
} 


And finally we use the new class: 


// exl.cpp: Using the List class 
// from Chapter 6 of Getting Started 
#include "list.h" 


main{) 
{ 
List 1(5); 
int i = 0; 
// Insert the numbers 1 through 5 
while (1.put_elem(i+1,i) == 0) 
+71; 
l.setn(i); 


l.print (); 
} 
Output 1 
2 
3 
4 
5 
Program 8 


Build STACK.OBJ and LIST.OBJ // stack2.h: A Stack class derived from the List class 
with EX8.CPP, or use EX8,PRJ. // from Chapter 6 of Getting Started 


#include "list2.h" 


class Stack : public List // line 5 
{ 
int top; 
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public; 
Stack() {top = 0;}; 
Stack(int n) : List(n) {top = 0;}; // line 11 
int push(int elem); 
int pop(int& elem); 
void print(); 


)j 


To define a derived class, the base class definition must be avail- 
able, so we include its header file (line 3). Line 5 informs the com- 
piler that the Stack class is derived from the List class. The key- 
word public states that the public members of List should be con- 
sidered public in Stack also (this is what is usually needed). Since 
the List class has a constructor that takes an argument, the Stack 
constructor invokes the List constructor directly (line 11). Base 
class constructors are executed before those of a derived class. 


// stack.cpp: Implementation of the Stack class 
// from Chapter 6 of Getting Started 

#include <iostream.h> 

#include “stack.h" 


int Stack::push(int elem) 
{ 
int m = getmax(); 
if (top < m) 
{ 
put _elem(elem,toptt); 
return 0; 
else 
return -1; 


int Stack::pop(int& elem) 
{ 
if (top > 0) 
{ 
get_elem(elem,--top) ; 
return 0; 
} 
else 
return -1l; 


void Stack: :print () 
{ 


int elem; 


for (int 1 = top-l; i >= 0; --i) 
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{ // Print in LIFO order 
get_elem(elem, i); 
cout << elem << "\n"; 


} 
} 


Note that the public member functions of the List class can be 
used directly, because a Stack is a List. However, the private 
members of the List portion of a Stack object cannot be referenced 


directly. 


// ex8.cpp: 


Using the Stack Class 


// from Chapter 6 of Getting Started 
#include "stack.h" 


main() 

{ 
Stack s(5); 
tnt 15-0; 


// Insert the numbers 1 through 5 
while (s.push(itl) == 0) 


t+1; 


S.print (); 


— 


Output 


Rr Bh W& ES 


Program 9 


Sometimes it is convenient to allow a derived class to have direct 
access to some of the private data members of a base class. Such 
data members are said to be protected. 


Build EX9.CPP, LIST2. OBJ, 


// list2.h: 
STACK2. OBJ, or use EX9.PRJ 


A Integer List Class 
// from Chapter 6 of Getting Started 


const int Max elem = 10; 


class List 


{ 
protected: 


int *list; 


int nmax; 
int nelem; 
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// The protected keyword gives subclasses 
// direct access to inherited members 

// An array of integers 

// The dimension of the array 

// The number of elements 
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public: 
List (int n = Max elem) {list = new int{n]; nmax = n; nelem = 0;}; 


h; 


~List() {delete list;}; 

int put elem(int, int); 

int get elem(int&, int); 

void setn(int n) {nelem = n;}; 

int getn({) {return nelem;}; 

void incn() {if (nelem < nmax) +tnelem;}; 

int getmax() {return nmax;}; 

virtual void print(); // line 22 


We can now replace calls to List’s member functions with direct 


references to List’s data in the Stack implementation. 


// stack.cpp: Implementation of the Stack class 
// from Chapter 6 of Getting Started 

#include <iostream.h> 

#include “stack.h" 


int Stack::push(int elem) 


int m = getmax(); 
if (top < m) 
{ 
put_elem(elem, top++) ; 


return 0; 
} 
else 

return -l; 


int Stack::pop(int& elem) 


{ 


if (top > 0) 
{ 
get _elem(elem,--top); 


return 0; 
} 
else 

return -1; 


void Stack: :print () 


int elem; 


for (int i = top-1l; i >= 0; --i) 
{ // Print in LIFO order 

get _elem(elem, i); 

cout << elem << "\n"; 
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Output 


} 
And then we can try it out: 


// ex9.cpp: Using the print() virtual function 
// from Chapter 6 of Getting Started 

#include <iostream.h> 

finclude "stack2.h" 


main() 

{ 
Stack s(5); 
List 1, *lp; 
int i = 0; 


// Insert the numbers 1 through 5 into the stack 
while (s.push(itl) == 0) 
++i; 


// Put a couple of numbers into the list 
l.put_elem(1,0); 

l.put_elem(2,1); 

l.setn (2); 


cout << "Stack:\n"; 
lp = &8; // line 22 
lp->print (); // Invoke the Stack print() method; line 23 


cout << "\nList:\n"; 

lp = &1; 

lp->print (); // Invoke the List print() method; line 27 
} 


Stack: 


rR BO GD SS 


The above example illustrates polymorphism (also known as “late 
binding” or “dynamic binding,” which in C++ is accomplished 
using virtual functions). This means that an object’s type is not 
identified until run time. By defining the print member function to 
be virtual (see line 22 of “list2.h”), we can invoke the different 
print member functions through a pointer to the base class. In line 
22 above, lp points to a Stack object (remember: a Stack is a List), 
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summary 
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so the Stack print method is invoked in line 23. Likewise, the List 
print member function is executed in line 27. 


There is much more to C++ than this chapter covers (multiple in- 
heritance, for example). As stated at the beginning, this chapter is 
intended give you a sense of the “look and feel” of C++, to show 
how it differs from C, and to demonstrate how to use most of the 
basic features of C++. For more information on the basic concepts 
of C++, read or review Chapter 5, “A C++ primer,” Chapter 1, 
“The Turbo C++ language standard,” in the Programmer's Guide 
gives more advanced material on C++. And check the 
bibliography; it provides a list of books on C++, including books 
specific to Turbo C++. 
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Debugging in the new IDE 


In Chapter 4, you learned the major elements of C. Through a 
variety of examples, you learned how these elements are put 
together to create working programs. With that knowledge, 
you've probably already written your own short programs. If not, 
now is a good time to begin, because there is nothing like writing 
your own code to test and extend your understanding of the 
concepts we have been discussing. 


Of course, writing programs means dealing with your mistakes. 
Most experienced programmers agree that tracking down logical 
problems, commonly called bugs, in programs is a major part of 
program development. Debugging, or finding and fixing bugs, 
can often take longer than writing the program itself. 


Turbo C++ comes with an integrated, source-level debugger that 
provides many capabilities of a standalone debugger, while 
giving you the convenience and speed of remaining within the 
integrated environment. 


Source level means that you can trace through your actual program 
code—including, if you wish, every function that your code calls. 
By setting breakpoints, you can control how much of your pro- 
gram is run before you examine its condition. You can find out 
the current value of any variable by selecting it with the cursor or 
typing its name in the Evaluate field. You can set watches that 
monitor one or more variables and display their changing values 
as the program runs. All of this is done without your having to 
stop thinking in C (or C++), since you use the same variables, 
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Inspect... 


Evaluate... 


Call stack... 


Watches 


Toggle Breakpoints 


Breakpoints 


expressions, and operators you have been using to write your 
program. 


Type Tc to start Turbo C++ (if it isn’t already running), and take a 
few minutes to examine the Debug menu. Highlight each item on 
the menu in turn, pressing F1 each time to view the associated 
help text. These menu options are the debugging tools that you'll 
learn to use while developing this chapter’s example program. 


[a] 


Inspect 
ie C7 


Data Inspect 


[a] Evaluate and Modify 


»Expression 
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| 
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Add watch Ctr]-F7 
Delete watch 

Edit watch 

Remove all watches 


[a] ‘Breakpoints 


»Breakpoint List Line# Condition 
» 
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Debugging and program develooment 
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While this chapter focuses on debugging, it’s important not to 
treat debugging as something separate from designing and 
writing a program. Turbo C++’s integrated debugger makes the 
mechanics of finding and fixing bugs as easy as possible, but the 
way you design your program can help make debugging easier, 
too. 
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Consider the old tube televisions. They were hard to repair 
because all their parts were wired into one big mass of tubes, 
resistors, capacitors, and so on. This often made it hard to find out 
which part or parts were not working. When you found the part 
that needed to be replaced, it was hard to get at that one part in 
the mass of wires. 


After transistors and integrated circuits came into use, people 
started designing TVs differently. Each circuit came on its own 
slide-in module, which could slide out for easy access and testing. 
To replace a defective module, you simply slid in a replacement. 


The C equivalent of these plug-in modules is the function. You'll 
design, implement, and test the example program in this chapter, 
one function at a time. It is often tempting to write a whole pro- 
gram, particularly if it is a small one, and only then start debug- 
ging. Like the old TV, though, this makes things unnecessarily 
difficult. To see why, suppose main calls a function b, which in 
turn calls functions ¢ and d. If you don’t test each of these 
functions as you develop them, it will be hard to tell whether a 
possible problem in function d is due to a coding error there, or to 
one in b or c. Of course, there is often more than just one bug. 
Meanwhile, a seemingly unconnected function a may have 
modified global data that b needs to pass to c. You can see that 
incremental program development—developing and testing one 
part of your program at a time—can save you considerable time 
and frustration. 
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Figure 7.1: Program development flowchart 
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Designing the example program: PLOTEMP.C 


The example program for this chapter collects temperature read- 
ings and displays them using either a table or graph view. It 
illustrates a diverse assortment of Turbo C++ capabilities: console 
and file 1/O, passing an array to a function, and some graphics 
charting functions. Later, if you want, you can modify 
PLOTEMP.C to work with other kinds of data, and to provide 
different kinds of reports and charts. 
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One of the best ways to design a program is to prototype it by 
showing how it interacts with the user—how it requests informa- 
tion, responds to commands, and displays information. Before 
looking at the program code, let’s see what the program will look 
like from the user's point of view. 


When you run PLOTEMP.C, it displays this menu: 


Temperature Plotting Program Menu 
E - Enter temperatures for scratchpad 
S - Store scratchpad to disk 
R - Read disk file to scratchpad 
T - Table view of current data 
G = Graph view of current data 
X - Exit the program 
Press one of the above keys: 
If you press E, you are prompted for a set of temperature read- 
ings. The program is set up to handle a set of eight readings, but 


you can change this simply by changing the line 
#define READINGS 8 
near the beginning of the program code. 


Data entry will look something like this: 


Enter temperatures, one at a time. 
Enter reading # 1: 52 
Enter reading # 2: 55 
Enter reading # 3: 62 
Enter reading # 4: 65 
Enter reading # 5: 73 
Enter reading # 6: 76 
Enter reading # 7: 68 
Enter reading # 8: 61 
After this or any other menu selection except X (for Exit), the 


menu is redisplayed. 


Choosing S saves the data set currently in memory to a disk file 
(you are prompted for the file name). Choosing R reads a data set 
from the disk file you specify to the program's “scratchpad” data 
array. 


Once you have data in the scratchpad (either by entering it from 
the keyboard or reading it from disk), you can display a summary 
table of the data by choosing T (for Table view): 


Reading Temperature (F) 


Onan WN 
~l 
nn 


Minimum temperature: 52 
Maximum temperature: 76 
Average temperature: 64.000000 
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As an alternative, you can select a graph view of the current data 
by choosing G, as shown in the following figure: 


Figure 7.2 
Graph view of temperature 
data 


Plot of Temperature Readings 
Sa 33 62 


Press any key to continue 


There’s one problem: The program you'll be putting together 
won’t run entirely as expected. You'll have to use the debugger to 
find and fix the bugs. 


Writing the prototype program 


Having decided what the program should do, you can determine 
what global data and other definitions the program will need, and 
write the main function: 


You can load this file right /* PLOTEMP1.C--Example from Chapter 7 of Getting Started */ 
now: File | Open! PLOTEMP1. 


As you load and run these /* This program creates a table and a bar chart plot from a 
successive pieces of code, set of temperature readings */ 
remember that we've 
deliberately sprinkled them #include <conio.h> 
with bugs. #include <ctype.h> 


#include <stdio.h> 
#include <stdlib.h> 


/* Prototypes */ 


void get_temps (void); 
void table view(void); 
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void min_max(void); 
void avg temp (void) ; 
void graph view(void) ; 
void save temps (void); 
void read temps (void) ; 


/* Global defines */ 


tdefine TRUE 1 
#define READINGS 8 


/* Global data structures */ 
int temps [READINGS]; 


int main (void) 
{ 
while (TRUE) 
{ 
printf ("\nTemperature Plotting Program Menu\n") ; 
printf("\tE - Enter temperatures for scratchpad\n"); 
printf("\tS - Store scratchpad to disk\n"); 
printf("\tR - Read disk file to scratchpad\n") ; 
printf("\tT - Table view of current data\n"); 
printf("\tG - Graph view of current data\n"); 
printf ("\tX - Exit the program\n"); 
printf("\nPress one of the above keys: ") 


switch  (toupper(getche())) 

{ 
case 'E’:; get temps(); break; 
case ‘'S’; save temps(); break; 
case 'R’: read temps(); break; 
case 'T’; table view(); break; 
case 'G’: graph view(); 
case 'X!’: exit(Q); 


} 
/* Function definitions */ 


void get_temps (void) 
{ 

printf("\nExecuting get_temps().\n"); 
} 


void table view(void) 
{ 
printf("\nkxecuting table view().\n"); 


void min max (void) 
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printf("\nExecuting min max().\n"); 


} 


void avg temp (void) 


{ 
printf ("\nExecuting avg temp().\n"); 


} 
void graph _view(void) 
{ 
printf£("\nExecuting graph view().\n"); 


} 


void save temps (void) 
{ 
printf("\nExecuting save temps().\n"); 
} 
void read temps (void) 
{ 
printf ("\nExecuting read temps().\n"); 


} 


Notice the following important features of this prototype 
program: 
m Global #defines and data structures (the array temps). 
= The function main provides the top-level menu. 
= Other functions are declared with void return and argument 
type. 
m Each function contains only a printf statement that identifies it 
when it is executing. 


m The program is already complete enough to execute. 


Why are functions given void declarations? They let you run the 
program and check the flow of execution at the top level. If you 
gave the functions full ANSI prototypes with arguments of 
various data types, you would have to start implementing the 
function definitions and writing code to use the values passed to 
the functions. Otherwise, you would receive compiler warnings 
about unused parameters. A good rule of program development 
is “do one step at a time, test one step at a time.” At this point, 
you want to verify that the top-level structure of the program is 
sound. 
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Using the integrated debugger 


Compile PLOTEMP1.C by choosing Compile | Build All. The 
compiler halts after displaying the error message: 


Error C:\TC\EXAMPLES\PLOTEMP1.C 43: 
Statement missing ; in function main 


Turbo C++ has found a syntax error. You will usually have to 
wade through a flock of syntax errors before you can actually run 
your program, let alone debug it. Fortunately, syntax errors are 
usually easy to fix. Press the space bar: Here, the error bar high- 
lighted the first line of the switch statement that displays the 
menu. A reference to a missing semicolon usually refers to the 
preceding statement (in this case, the last in the preceding group 
of printf statements). As you probably recall, you can press Enter 
or F6 to switch to the Edit window and make your correction. If 
you have more than one syntax error to deal with, press F6 to 
switch back to the Message window, and then use Alt-F8 (or the 1 
key) to move to the next error listed. 


Now that you've fixed the syntax error, compile the program 
again. This time the compiler and linker run without error 
messages, which means the program is now free of syntax errors. 


Now choose Run! Run to ran PLOTEMP1.EXE. You'll see the 
program's menu. Try pressing each of the keys listed in the 
menu—exercise the program. Try both uppercase and lowercase 
letters. Try letters that aren’t given on the menu at all. What 
happens in each case? Did everything work as it should? 


You probably noticed that with each selection made from the 
menu, a line describing the function was displayed. (Remember 
those printf statements in the stub functions in the listing?) 
Usually, the menu was then redisplayed. If you press X (or x), the 
program exits, and you are returned to Turbo C++. What happens 
when you press G (or g), though? You are also returned to Turbo 
C++. That’s not right—you should get the menu again. There’s a 
bug lurking somewhere. 
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Tracing the flow of a program 


Tracing high-level 
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execution 


By using options on the Run menu and observing the run bar, you 
can observe the order of execution of your program’s statements 
and control how detailed the tracing will be. 


Choose Run | Trace Into (or press F7). The debugger scrolls the 
beginning of function main into the Edit window and highlights 
it. This highlight is called the run bar and marks the execution 
position, indicating the next statement to be executed. 


To trace the high-level flow of your program, choose Run | Step 
Over (or press F8), and the next line containing code is executed 
(comment lines are skipped over). As you continue pressing F8, 
the run bar moves through the series of printf statements that 
display the menu. The screen appears to flicker. This is because 
each time the debugger executes a statement that displays infor- 
mation onscreen or executes a function call, it momentarily 
switches to the User screen. This is the screen display your pro- 
gram would generate if you weren’t executing it within Turbo 
C++’s integrated environment (but the screen switching happens 
too fast for you to see the output). To look at the User screen, 
choose Window | User Screen, or press Alt-F5. Depending on how 
far you've gotten in executing the printf statements, you'll see part 
or all of PLOTEMP’s menu. Press any key to switch back to the 
debugger. 


Continue pressing F8 until you reach the first line of the switch 
statement. This line contains a call to the getche function, which 
requires the user to input a character. Any time user input is re- 
quested by the program, Turbo C++ switches to the User screen. 
Since you want to observe what happens when the graph view 
(G) option is selected, press F8 again, then press G. After you 
supply the requested input, the display switches back to the 
debugger, and the run bar moves to the following statement: 


case 'G’: graph view(); 


So far, so good. The next time you step, however, the following 
statement is exit, and you will be back in the editor the next time 
you step. Press F8 to verify that the program finishes. By now, 
you've probably noticed that a break statement is needed on the 
preceding line. Correct the line so that it reads: 
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case 'G’: graph view(); break; 


Now let's see if the fix worked. You could start the program and 
step one line at a time all the way from the beginning, but that 
would be tedious. Instead, choose Run | Go to Cursor (or press F4; 
make sure the cursor is on the correct line). Rebuild the program 
(say yes to the “OK to rebuild” prompt); its lines execute until 
user input is needed. Press Gin response to PLOTEMP’s menu; 
execution continues up to the line you just fixed. Continue 
stepping. Notice that this time the break statement is executed, 
and the execution position then goes back to the top of the while 
loop. PLOTEMP’s menu now appears to be operating correctly. 


Tracing into 


called functions When you use Run! Step Over, only the highest level of your pro- 
gram is stepped through. As you saw, the run bar stayed within 
the main function, stepping through the printf statements and the 
various cases within the switch statement. Often, however, you 
need to trace into the functions called by your main function, and 
sometimes the functions called by the functions. To trace through 
function calls, choose Run | Trace Into, or press F7. 


Try this now: Trace through the program, and press Eat the 
PLOTEMP menu. This time, the run bar goes to the appropriate 
case in the switch statement, and then goes into the definition of 
the get_temps function. After stepping through the function 
(right now, there's just a printf statement there), execution falls to 
the bottom of the big while loop in main, then returns to the top 
where the menu is redisplayed. 


Continuing program develooment 


Through the rest of this chapter, you will be adding one function 
at a time to PLOTEMP and then testing it by running the program 
again. Instead of making you do all the work of typing in code, 
we've provided incremental versions of PLOTEMP that you can 
load to complete each step. If you were debugging one of your 
Own programs, you would follow these steps: 


1. If necessary, replace the function prototype with the complete 
one. 
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For code that includes these 
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changes, then load 
PLOTEMP2.C. 


2. Replace the stub function definition with the actual code 
needed to perform the task. 


3. Test the new function by running the program again, making 
the appropriate choice from its menu. 


4, Fix any bugs that crop up, testing until there are no more 
bugs. 

5. Implement the next function in the same way, until the 
fleshed-out program is complete. 


For best and fastest results, write, compile, run, and debug each 
function separately. Don’t start developing the next function until 
you have a working program that has no apparent errors. This 
strategy won't eliminate all bugs, because “hidden” bugs some- 
times continue to lurk, waiting for some unforeseen combination 
of circumstances. But this incremental approach minimizes the 
chance of unexpected crashes. 


Start with the get_temps function, which gets a set of temperature 
readings from the keyboard. Since it doesn’t take any arguments, 
and doesn’t return anything directly, the current prototype 
declaration, 


void get_temps (void) 


doesn’t need to be changed. (A full production version of this 
program would probably have this and every function return a 
value, so any errors could be signaled. We omit this here in the 
interest of keeping the size and complexity of the program 
manageable.) 


Find the existing definition of get_temps. Right now, it’s a stub 
definition that just prints a message when it executes. Replace the 
existing code with the following: 


void get temps (void) 
{ 
char inbuf[130]; 
int reading; 


printf("\nEnter temperatures, one at a time.\n"); 
for (reading = 0; reading < READINGS; reading++) 
{ 

printf("\nEnter reading # td: ", reading + 1); 

gets (inbuf) ; 

sscanf(inbuf, “%d", temps[reading]}); 


/* Show what was read */ 
printf("\nRead temps[%d] = %d", reading, temps[reading]); 
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setting breakpoints 


Remember that arrays in C 
begin with element 0: The first 
reading goes into element 0, 
the second into element 1, 
and so on. 


A breakpoint is a place in 
your program where you 
want execution to run fo, 

then stop at. 


If get_temps works correctly, the for loop will prompt for each 
reading, then will use gets to get the reading as a string. Next, it 
uses sscanf to store it in the corresponding element of the temps 
array, and use another printf statement to display the value stored 
in the array. This second printf statement is just a temporary 
expedient: It lets you see how your inputs are being stored. After 
this function is debugged, you can remove it. 


Run PLOTEMP2 and press E at the PLOTEMP menu so that 
get_temps executes. As you enter the data, something like this 
happens: 

Enter reading # 1: 40 


Read temps[0] = 0 
Enter reading # 2: 50 


Read temps{1] = 0 
Enter reading # 3: 55 


Read temps[2] = 0 
Enter reading # 4: 57 


Read temps[3] = 0 
Enter reading # 5: 61 


Read temps[4] = 0 
Enter reading # 6: 64 


Read temps[{5] = 0 
Enter reading # 7: 65 


Read temps[6] = 0 
Enter reading # 8: 60 


Read temps[7] = 0 
What's happening here? Regardless of what data you enter, the 


corresponding element of the femmps array remains set to 0. Some- 
how the data being entered isn’t finding its way into the array. 


Clearly, this code needs closer examination. To run the program 
until a particular area of interest is reached, set a breakpoint. 
Move the cursor to the beginning of the loop in the get_temps 
function: 


for (reading = 0; reading < READINGS; readingt+) 
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lf you choose Toggle 
Breakpoint for a line that 


already has a breakpoint. it 


removes that breakpoint. 


Instant breaking 
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with Cirl-Break 


Now choose Debug | Toggle Breakpoint (or press Cirl-F8) to set a 
breakpoint at this line. The line with for is highlighted. Any time 
the flow of execution reaches a line at which you have set a break- 
point, the program is interrupted, and you’re returned to the 
debugger. As you'll soon see, this lets you use other debugger 
commands to examine and change variables and other data 
structures. When you have several breakpoints in a program, you 
can choose Debug | Breakpoints and select the View button in the 
dialog box to see the next breakpoint. 


Breakpoints stay set until you do one of the following: 


m Leave the integrated environment. 

m Toggle the breakpoint off with Ctr-Fé. 

m Delete the breakpoint using Debug | Breakpoints | Delete. 
m Delete the line(s) on which the breakpoints are set. 


w Edit a file containing breakpoints and abandon the file without 
saving it. 


Any time you correct a bug or otherwise edit the current file, and 
resume using debugger commands, Turbo C++ asks, “Source 
modified, rebuild?” Normally you’d press Y at this prompt, so the 
program can be rebuilt into a version that reflects your changes. If 
you press N, both breakpoints and the run bar will appear in the 
wrong places because the source file no longer matches the 
executable program. 


You probably know that pressing Cirl-Break allows you to “break 
out” of many running programs. And so it is with Turbo C++ and 
the integrated debugger. However, the debugger doesn’t always 
stop the program instantly. The debugger waits until the machine 
code corresponding to one of your lines of source code is being 
executed. It then stops the program at the machine instruction 
that corresponds to the beginning of the next source code line. 
The run bar appears on the line following the last line executed. 


If you really want an instant break, press Cirl-Break twice. When 
the second keypress is detected, the debugger terminates the pro- 
gram immediately, without flushing any output or calling any exit 
functions. (This is similar to using the _ exit function.) This 
“double break” is usually undesirable, since the contents of data 
files become unpredictable, and the debugger no longer knows 
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what line will be executed next. You'll probably only want to use 
a second Cirl-Break when your program is “hung” or stuck in an 
infinite loop. 


Run the program again; the PLOTEMP menu is displayed. Press 
E. The program runs into the get_temps function until the 
breakpoint is reached. Step with F8 until the run bar has moved 
through the statements in the body of the for loop and returned to 
the first line of the loop. Now it’s time to look at the key variables 
to learn more about the bug. 


Inspecting your data 


Complex programs usually use a variety of data structures— 
arrays, structures, unions, lists, and so on. To understand what is 
going on in a particular part of your program, you often need to 
know the actual contents of these data structures. Turbo C++ pro- 
vides a new facility called inspectors. Inspectors let you raise the 
hood at any part of your program and examine the inner 
workings. 


InNsoector 


WINGOWS | To open an Inspector window for an item, move the cursor to the 
y item in the Edit window and press Alt-F4. (You can also choose 
ou can inspect any legal C : : : 
or C++ expression, provided Debug | Inspect.) Try inspecting the variable reading from your 
it doesn’t contain symbols current version of PLOTEMP2.C (which should currently be in 


that were created with the Edit window). Choose Run | Trace Into, then Debug | Inspect. 
#define or function calls. 


All Inspector windows begin with the name of the item. For 
variables, the line below contains the address of the variable, 
expressed as segment:offset. (Variables that have been declared to 
be of register type, or that have been optimized by Turbo C++ 
and thus placed in registers, don’t have an address, since they are 
being stored in the CPU rather than in RAM. Instead, you'll see 
the word register.) The next line describes the item’s data type (for 
example, unsigned int). 


The actual value of the item is displayed to the right of the data 
type. Turbo C++ automatically selects the appropriate formats for 
displaying the type of data involved. For nonprinting characters, 
a backslash (\) followed by the hexadecimal character value is 
used in place of the character value. An int variable, on the other 
hand, would have decimal and hexadecimal values but no char- 
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Inspecting arrays 


and strings 


Figure 7.3 


Inspecting the femps array 


Inspecting structs 
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and unions 


Inspecting 
pointers 


acter representation. The other numeric types are handled 
similarly. 


For an array, a separate line is shown in the window for each 


element—if there are more elements than will fit in the window, 


use the arrow keys to scroll through them. For a string, a 
character representation for the string as a whole is also shown. 
The next figure shows the array temps from PLOTEMP.C after it 
has been filled with data via the get_temps function. 
BS Inspecting temps Sozo yl 
8E8F:12 

0 55 ax0037) 
58 {0x003A) # 
61 Seer 


69 (0x0045) § 
eames cede oo 48 


The display for strings is similar to that for arrays (they are, after 
all, the same data structure). With strings, however, the character 
representation of the string is shown in addition to the individual 
elements. 


For structures and unions, the values of the individual members 
are shown. To see how this works, load SOLAR.C (which you saw 
in Chapter 4, “An introduction to C”) and inspect the array 
solar_system. Since this is an array whose elements are structures 
of type planet, you can browse through the array elements and 
view the data stored in the members of each planet structure. 


For a pointer, the Inspector window shows the address of the 
pointer, the address the pointer points to, and the data found at 
that address (which can be a simple variable, an array, a structure, 
and so on). Indexes ([0], [1], and so on) are shown to make it easy 
for you identify the position of each piece of data. This program 
defines a character pointer ptr: 


main() 
| 


char * ptr = "This is a string\n"; 
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Inspecting 
FUNCTIONS The Inspector window for a function shows its return type and 
address, as well as all of the function’s parameters. The Inspector 


window for the function min_max from the complete version of 
PLOTEMP.C is shown in the next figure. 


Figure 7.4 [=}- aa mee —1=[*] 
Inspecting the min_max eda 
function 
You can use function inspectors to review a function’s return type 
and parameters without having to go back to the function 
declaration. 
When should you 


use inspectors? Using inspectors may seem like overkill when dealing with 
simple variables and even arrays, since the Debug | Evaluate 
option (discussed later) also shows the values of variables. The 
real advantage of inspectors comes when dealing with more 
complex data structures (structures, unions, and arrays of these 
data types). In general, inspectors are most useful for studying 
your data in depth, while the Debug | Evaluate facility is best for 
taking a quick look at simple data. 


Evaluating and changing variables 


Load PLOTEMP2.C, compile it, and step to the last printf in the 
function get_temps. Select E and enter one reading. You should 
now have executed the contents of the for loop once, and input, 
formatted, and stored one reading (via the gets and sscanf 
functions). Now choose Debug | Evaluate, which pops up a 
window containing three fields: 


m the Expression field, which contains the expression you are 
interested in 


m the Result field, which displays the value of the expression in 
the Evaluate field 
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m the New Value field, where you can enter a new value for the 
selected expression 


By default, the “word” (C variable, keyword, function call, and so 
on) at the cursor is displayed in the Evaluate field. You’re 
interested in two variables: reading, which is the loop’s counter 
variable, and the array temps, which is supposed to contain the 
input data. 


Type reading and press Enter. The debugger now displays 0 in the 
Result field. If you step through the statements in the loop and 
evaluate reading again, you'll find its value is now 1. 


You can also examine the values of more complex data structures, 
such as arrays, strings, and structures. Here, you want to know 
more about what's happening to the array temps. Go ahead and 
type temps in the Evaluate field. The following is displayed: 


(0, 0, 0, 0, 0, 0, 0, 0} 


This shows the integer values currently stored in the array temps. 
You can get a single value by using an index: Specifying temps [0] 
would get you the first integer, for example. Or you could open 
an Inspector window. 


Notice that we have been referring to expressions, not just values 
(such as variables) by themselves. Recall that an expression is a 
combination of variables, constants, and operators that yields a 
single value; for example, valsl [index] + vals2[index] + 1. You 
can display the value of any expression, provided that 


m It doesn’t involve a function call (so an expression such as 
sqrt(a) + 1 can’t be used). 

m It doesn’t use a #define value, such as READINGS in the 
current program. 


For practice, get the values of the following expressions by typing 
them into the Evaluate field: 


reading + 2 
temps[reading + 1] 


specifying display 
format Optionally, you can add a comma and a format specifier to the 
value you want displayed. For example, type reading,h to see the 
current value of reading in hexadecimal (you could also type 
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reading, x). By default, integers are displayed as decimal, and 
character arrays are displayed as strings. 


The specifier m is useful when dealing with arrays: It displays a 
memory dump starting at the specified address. For example, 
temps,m gets you a memory dump starting at the location specified 
(since temps is an array, its name points to the starting address of 
stored data): 


00 00 00 00 00 00 00 


This shows that all the elements of the array temps are currently 
set to 0. The number of elements displayed depends on the size of 
the array. You can combine m with other specifiers: 


temps ,mh 
displays a memory dump in hexadecimal format. 


Another useful specification is p, which displays the selected 
variable as a pointer, giving information about the area of 
memory being pointed to (for example, the Interrupt Vector 
Table, the BIOS data area, or the user program’s program segment 
prefix [PSP]). If the memory pointed to is within the program’s 
own allocated memory, the name of the variable (if any) at the 
address of the segment offset is also displayed. (Chapter 4, “Mem- 
ory models, floating point, and overlays,” in the Programmer's 
Guide has more information about the regions of memory 
involved.) 


specifying the 
number of values When dealing with an array, you can specify how many values 
you want to display: temps, 5 specifies the first five elements of the 
array temps. You can combine this repeat count with format speci- 
fiers. For example, temps [2], 3h specifies that the three elements 
following the third element of the temps array should be dis- 
played in hexadecimal format. 


Other format specifiers and more details of the debugger com- 
mands are given in the Lser’s Guide, Chapter 1, “The IDE refer- 
ence” (a reference chapter for the integrated environment). After 
you practice using the debugger in this chapter, we recommend 
reading the pertinent portions of that chapter. 
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Copying from the 
cursor position 


specifying 
variables in other 
functions 


Changing values 
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As noted earlier, the Evaluate field contains whatever word was 
at the cursor position when you chose Debug | Evaluate. You can 
take advantage of this to save typing. For example, if you move 
the cursor to the beginning of the expression 


temps [reading] 


temps appears in the Evaluate field. As you press —-, the 
characters following the word temps appear. You can thus copy 
the complete expression temps [reading] into the Evaluate field, 
then press Enfer as usual to display the value. 


Right now, you’re looking at the variables reading and temps in the 
function get_temps. You can also ask the debugger for the values 
of static variables in other functions because static variables retain 
their values even when the function that uses them isn’t being 
executed. You can also look at variables in the functions that 
called the one you’re executing. You can’t look at ordinary auto- 
matic variables declared in other functions because they no longer 
have a value when their function exits. The context in which 
expressions are evaluated is given by the current cursor position 
in the Edit window. 


To specify a variable outside of the current function, you can 
move the cursor into the body of the function, or you can give the 
name of the function, a period, and the name of the variable. 


If the variable you want to inspect is in another program module, 
you must specify the module name first; for example, 


module2.getvals.count 


Now you know how to look at different kinds of variables and 
expressions, and how to see their values in different formats. 
Practice stepping through the for loop in get_temps and examine 
the values of reading and temps{reading]. The latter insists on 
always being 0. 


Try evaluating the expression temps [reading] as you step a few 
times through the loop. The debugger displays its value as 0, 
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regardless of the value of reading. But what should this expression 
represent? Since it is specifying the storage destination for the 
sscanf function, it needs to be an address. This means that all of 
the values entered are being stored at address 0! You can confirm 
this by using the pointer format temps [reading] ,p and finding that 
that value is still 0. 


You need to use the address operator & to make this expression 
refer to the address of the temps array. Evaluate &temps [reading] ,p. 
The result will look something like this: DS:1278 temps+1. The 
actual values displayed will depend on your system configuration 
and the current value of reading, but you can see that 

&temps [reading] points to a bona fide address in the data segment, 
with an offset from the address pointed to by the variable temps. 


Change the expression temps[reading] in the sscanf statement to 
&temps [reading]. If you now continue stepping through the pro- 
gram, you will be asked whether to rebuild the program; press Y 
for Yes. Now, if you step through the for loop again and evaluate 
temps [reading], you'll find that the values you are entering are 
stored correctly in the array. 


This is a good time to practice changing values with the debugger: 
Evaluate the current value of temps [reading]. 


Use the Tab key to move among the three fields (Evaluate, Result, 
and New Value). Once the input cursor is in the New Value field, 
type a value such as 66, and press Enter. Now, if you type 

temps [reading] in the Evaluate field, its new value, 66, is shown in 
the Result field. You can change the value of any expression that 
represents a single data element, such as a simple variable, a 
pointer, or an array element. 


Changing values interactively with the debugger is useful for 
temporarily fixing a bug and continuing program execution a 
little further, looking for the next bug. Here, for example, you 
could put new values in temps[0] through temps[7], set reading to 8 
to break out of the for loop, and return to the program's main 
menu. You can also force a function to return a specific value, or 
to pass that value to another function. This lets you test unusual 
conditions that might lead to bugs, without having to put 
temporary assignment statements in your code. 


The get_temps function should now be working correctly. Next, 
implement the table_view function, so you can view the entered 
data. Replace the stub code for table_view with the following: 
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Load in PLOTEMP3.C. void table view (void) 
{ 


int reading; 


clrscr(); /*clear the screen */ 
printf ("Reading\t\tTemperature (F)\n"); 


for (reading = 0; reading <= READINGS; readingt++) 
printf("sd\t\t\t%d\n", reading + 1, temps[reading]); 

min_max(); 

printf ("Minimum temperature: \n"); 

printf ("Maximum temperature: \n"); 

avg temp(); 

printf ("Average temperature: \n"); 


This function prints the table headings and then uses a for loop to 
obtain and print the values stored in the temps array. Eventually, it 
will also print the minimum, maximum, and average tempera- 
tures. These functions haven’t been implemented yet, so they'll 
just print out a message saying that they are being executed. 


Notice that including the called functions before they are imple- 
mented lets you test the program flow, and reminds you of the 
program structure. This kind of design is often called top-down 
because the program is designed at the top level first (the main 
function). You are in the process of designing the functions called 
directly by main, such as table_view here. When the top level of 
table_view is working, you'll then implement the functions it 
calls—min_max and avg_temp. 


Now build and run PLOTEMP3.C, choose E, and enter test data 
(we entered 10, 20, 30, 40, 50, 60, 70, and 80). When you are back 
at the menu, choose T (Table view), and you'll see something like 
this: 


Reading temperature (F) 


COnNOMPWPe 
fo 2) 
So 


Executing min_max(). 
Minimum temperature: 
Maximum temperature: 


Executing avg_temp(). 
Average temperature: 
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Monitoring your program by setting watches 


Well, you entered eight readings and got back nine! The last one 
had a value of 0. You probably suspect the infamous “one off” 
bug—getting one less or one more iteration ofa loop than you 
had expected. 


First localize the problem by setting a breakpoint at the first line 
of the for loop in table_view. To do this, move the cursor to that 
line and choose Debug | Toggle Breakpoint (or press Ctrl-F8). 


Now run the program again, enter the test data, and choose Table 
view. The program stops at the breakpoint in table_view; now 
you can see what's going on in this for loop. 


So far, you have obtained the values of variables by stepping 
through the program and using Debug | Evaluate to inspect their 
values. This is fine when you just need to inspect the values once, 
but when you're dealing with loops or repeated function calls, 
you also want to see how the values change. It would be very 
tedious to evaluate the variables by hand repeatedly. The debug- 
ger lets you monitor these changing values automatically by set- 
ting watches. A watch is an expression whose value is updated 
each time it is encountered in the running program. 


Adding a watch 


You are interested in two variables in this case: reading, which is 
incremented repeatedly by the for loop, and temps[reading], which 
holds the value being printed each time through the loop. Since 
the cursor is already nearby, the easiest way to set these watches 
is to move the cursor to the name of the variable you want to 
watch, and then choose Debug | Watches | Add Watch (or press 
Cirl-F7). Move the cursor to reading and try this; you'll see the 
pop-up window. As with Debug | Evaluate, the default name 
shown is the one at the cursor; simply press Enter. Use the same 
procedure to set a watch for temps[reading]. The pop-up window 
shows temps, but as with Debug | Evaluate, you can use > to copy 
the rest of the expression into the window, and then press Enter to 
set the watch. : 
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Watching your 
watches 


Controlling the 
debugger 
windows 


Now that you have set two watches, the variable name and value 
for each watch is shown in the Watch window: 


reading: 177 
temps[reading]: 92 


Since the loop hasn’t been run yet, the values shown (which may 
be different on your system) are meaningless, representing what- 
ever happens to be at the respective memory locations. 


Now start stepping through the loop (with F8). As you step, notice 
how the values change. After the first time through the loop, the 
values are 


reading: 0 
temps [reading]: 10 


assuming you entered your test data starting with 10 as described 
earlier. The next time through the loop, the watches display 


reading: 1 
temps[reading]: 20 


The last time the loop is executed, the values are 


reading: 8 
temps{reading]: 0 


This suggests that the loop exits only after reading reaches 8. 
When should it exit? Since there are eight readings entered, and 
reading starts at 0, the last value it should have during the loop is 
7, not 8. Now take a look at the loop exit condition: 


reading <= READINGS 


Checking your #defines at the beginning of the program, you see 
that READINGS is 8. Do you see the problem? To exit when 
reading is 7 (after processing eight readings), the condition should 
read reading < READINGS. Fix this, and rerun the program to see if it 
works correctly. 


If you have set more than a few watches, there won’t be room to 
see them all at once. You can scroll the Watch window using the 
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PgUp and PgDn keys, or move one line at a time with the T and J 
keys. 


This also works withinthe — If a particular watch expression is too long to fit in the window, 
Debug !Evaluate window. vou can see its beginning and end by scrolling it with the Home, 
End, << ,and — keys. 


Another way to see more is to zoom a window. See Chapter 1, 
“The IDE reference,” in the User’s Guide for how to handle the new 
environment’s windows. 


Remember that you can look at an entire screen of the program 
output at any time by pressing Alt-F5. Press any key to return to 
the environment. 


Now is a good time to practice using these features. 


Editing and 
deleting watches _ Its easy to edit, add, or delete watches. When the Watch window 
is active, the currently active expression is highlighted. To select a 
different expression, use the Home, End, Tord keys. 


You can't change the value To edit (change) the currently highlighted watch, you can choose 
or tne expression, only 1N@ Debug | Watches | Edit Watch. Even easier, as shown on the bottom 
expression itself.To change 
the value, use Debug | line of the screen, you can press Enter. The debugger opens a pop- 
Evaluate. up window with the selected expression, and you can edit it. 
Practice by changing the watch for temps[reading] to 


temps [readingt+1]. 


You already know how to add watches, but once the Watch 
window is active, there’s an easier way: Press ins. A pop-up 
window appears. You can type in the watch expression, add to it 
with the — key, or accept the default that was copied from the 
cursor position. 


To delete the current watch, choose Debug | Watches | Delete 
Watch, or simply press Del. Practice by deleting the watch for 
reading. You can delete all of the watches by choosing Debug | 
Watches | Remove All Watches. 


Finding a function 


definition Now that PLOTEMP.C is starting to flesh out, it’s harder to find 
the function you want to examine. The debugger provides a way 
to scroll the Edit window to a specified function definition. 
Choose Search | Locate Function, and Turbo C++ opens a dialog 
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Finding out who 


called whom 


You can always scroll back 


position by choosing the first 
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to the current execution 


function in the Call Stack 
window—in this case, 
min_max. 


box. Practice by typing get_temps (don’t type the parentheses after 
the function name, or the debugger won’t find your function). The 
definition of get_temps is now displayed in the Edit window. 
This is useful for reviewing the definition of a function, as well as 
for finding locations to set breakpoints and watches. 


Note that Search | Locate Function works only with functions that 
have source code in a file that has been compiled with debug 
information. Library functions such as printf can’t be found with 
Search | Locate Function, since their source code isn’t available in 
the integrated environment. 


In a complex program, there may be several levels of function 
calls, and you may find it hard to remember the order in which 
functions were called as the program executed to a particular 
breakpoint. The debugger can help you out here, too. Set a 
breakpoint that will halt the program at the place where you want 
to see the call sequence. For practice, set a breakpoint at the printf 
in min_max. 


Run the program and choose Table View. This will cause the 
program to stop at the breakpoint. Now choose Debug | Call Stack. 
A pop-up window lists all the functions that are waiting to finish 
execution at this point. The call stack has the most recently called 
function at the top, which in this case is min_max. It was called by 
table_view, which in turn was called by main. 


You can use the T and J keys to highlight a particular function in 
the Call Stack window. If you press Enter, the Edit window scrolls 
to show the last line executed in that function. Right now, 


m the last line executed in min_max is the first line of its defini- 
tion, since that’s where you placed the breakpoint. 


m the last line executed in table_view was the line containing the 
call to min_max. 


w the last line executed in main is the line that executed 
table_view; namely, case 'T’: table view; break;. 


In other words, min_max is currently being executed, and 
table_view and main are pending completion. 


Turbo C++ Getting Starfed 


Multiple source 
files 


As you work with longer programs, you'll find the features we’ve 
been discussing to be especially useful. Many substantial pro- 
gramming projects consist of several source files. The debugger 
automatically loads the file needed to fulfill your request into the 
Edit window. For example, if you use Search | Locate Function to 
find a function that is declared in a source file other than the one 
in the Edit window, the debugger loads the appropriate source file 
into the editor. If you've made any changes to the current file, you 
are first asked if you want to save the changed file to disk. The 
same thing happens when you use Debug | Call Stack to examine 
the last executed line of a function whose definition is in a 
different source file. 


Although the debugger makes it easy to work with multiple 
source files, it is good practice to debug only one or two source 
files at a time. Always test a given “bug fix” before moving on 
because there is always a chance that your fix did not work, or 
possibly even introduced new bugs. 


Preventive medicine 


Design 
defensively 


You'll soon resume the development and testing of PLOTEMP.C. 
To aid in this and future debugging efforts, take a look at some 
ways to minimize bugs, and look at some common “buggy” 
situations. 


Just as you can avoid accidents by driving your car defensively, 
you can avoid bugs by designing your program defensively. As 
you've seen, the design of PLOTEMP.C represents an approach to 
defensive design through top-down programming. 


Try to build up your program from functions whose purposes are 
simple and well-defined. This makes it easier to set up test cases 
and analyze their results. It also makes your program easier to 
read and modify. For example, if PLOTEMP.C combined both 
table and graph views in the same function, the code could easily 
become unwieldy. 
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Try to minimize the number of data elements each function 
requires and the number of elements it changes. This too makes it 
easier to set up test cases and analyze their results, and to read 
and modify your program. It also tends to limit the amount of 
havoc a misbehaving function can cause, letting you run the 
function several times in a single debugging session. A program 
designed this way is said to be loosely coupled. 


Write clearly | 


Write your code cleanly, with consistent indentation, liberal com- 
ments, and descriptive variable names. 


Keep your code simple. Express complicated operations in many 
simple statements rather than a few complex ones that show off 
your knowledge of C’s more obscure features. Turbo C++’s code 
optimization makes your code reasonably efficient, and it will be 
much easier to debug, read, and modify. 


Don’t try to squeeze the last bit of efficiency out of your program 
when you write it. When you try to make code as efficient as it 
can be, it also tends to become hard to read and debug. If your 
program turns out to be too slow when it’s done, that’s the time to 
decide which parts are worth speeding up, and how best to do it. 
(Turbo Profiler is the best tool for that task, anyway.) 


Be alert for opportunities to write functions that can be used more 
than one way in your program, or can be reused in other pro- 
grams. Writing and debugging one generalized function is 
usually easier than writing two or more specialized ones. 


systematic software testing 


Before a jet liner takes off, the crew goes through a systematic 
checklist to ensure that everything is working properly. Following 
a specific routine reduces reliance on fallible human memory. In 
the same way, you should work toward a standard approach to 
software testing: A checklist of steps that your experience shows 
will lead you to a reliable program. 


There is no one “right” way to test a program; your checklist will 
depend on the types of programs you write, your strengths and 
weaknesses as a programmer, and your personal style. The fol- 
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lowing checklist can serve as a starting point, since it reflects 
widespread experience. 


m Feed the program some input that is simple but not trivial. Try the 
unusual—for example, have you tried entering negative 
temperatures into PLOTEMP? Trace into the code using 
Debug | Evaluate and watch expressions liberally to check the 
values of data items. Correct the bugs you find, one or a few at 
a time. 


m Feed the program other sets of data that let you exercise the parts you 
couldn't test in the preceding step. If possible, have someone who 
is unfamiliar with your program interact with it at the key- 
board. Common experience shows that programmers have 
difficulty exercising their own programs properly because they 
know which values are appropriate and which aren’t. If your 
program is designed to be used by accountants, try to find an 
accountant. 


m Test every statement in your program. You may find bugs where 
you didn’t suspect they could exist. 


m Put aside the debugger and test the entire program for correct 
behavior. If the program will be used by other people who will 
expect it to be well-behaved, test its response to every type of 
error it could possibly encounter. A program that handles most 
types of errors well is said to be robust. 


Test modifications 


thoroughly When you modify a program, retest the affected parts thoroughly. 
You may have to retest parts that haven’t changed but are affected 
by the changes. 


If the program is complex, keep a record of the tests you have 
performed. When you modify the program, this record helps you 
repeat all the tests whose results could possibly be affected by the 
change. If the tests involve particular input files, save the files. 


Areas to watch 
carefully As you continue to learn C and to develop programs, keep a list 
of common bugs and coding errors, and check it as part of your 
debugging session. Here are some areas where many program- 
mers run into trouble: 
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m making out-of-bounds errors 

m confusing addresses versus values at those addresses 

m placing the increment and decrement operators incorrectly 
m not testing statements thoroughly 

m using Pascal syntax instead of C 


Each of these is discussed next. 


Give special attention to boundary conditions—conditions that make a 
program escape from a loop, fill an array, and so on. Bugs are 
especially likely to be manifested as failures to handle boundary 
conditions correctly. You've already seen how the condition 
reading <= READINGS caused one too many values to be displayed. 
Other problems could be caused by starting at 1 instead of 0. 


Always be careful about whether you are specifying an address or a 
value at that address. For example, don’t confuse the value 
temps[reading] with the address &temps|[reading]. 


Be careful with the increment and decrement operators ++ and ——. Is 
the value being incremented before or after it is used? 


Be alert for individual statements or expressions that must be tested 
more than one way, like these: 
switch ( stremp(a,b) ) ... 


stremp can return three values: 0 (a equals b), -1 (a is less than b), 
or +1 (@ is greater than b). This suggests that you should test the 
statement with three sets of input values to verify that stremp 
makes it do the right thing in each case. 


X = (x>0) ? func(x) : 0 ; 


This statement contains an “implicit if” that can produce two 
different results. 


Finishing PLOTEMP.C 
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You've installed and tested the prototype PLOTEMP.C and have 
implemented, tested, and debugged the get_temps and 
table_view functions. You've learned how to use all of the 
debugger features. The completion of PLOTEMP.C involves a 
series of exercises where you 
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m Replace the stub code for a particular function with the code 
given in the listing. We’ve made this easy for you by providing 
code for each step that has the corrections made to that point. 
All you need do is load the next version. 


w Change the function prototype (if necessary). 


m Test the function implementation using appropriate debugger 
facilities. 


m Find and fix the bugs. 
m Move on to the next function. 


The answers are given at the end of this chapter. 


Finishing 
table_view To finish this function, you need to implement the following two 
functions: 
Load PLOTEMP4.C. 


void min max (int num vals, int vals{], int *min val, int *max val) 
Remember that we have - 7 > ~ 
included deliberate bugs in ; ee 
the PLOTEMP programs so Uy eae 
you can practice your 


*min val = *max val = vals[0]; 
debugging skills. ~ 7 


for (reading = 1; reading < num vals; reading++) 
{ 
if (vals[reading] < *min val) 
*min val = &vals[reading]; 
else if (vals[reading] > *max val) 
*max val = évals[reading]; 


float avg temp(int num vals, int vals{]) 


int reading, total = 1; 


for (reading = 0; reading < num vals; reading++) 
total += vals[reading]; 


return (float) total/reading; /* reading equals total vals */ 


Since these functions have parameters and return values, change 
their prototypes to 


This change is included in void min max (int num vals, int vals{], int *min val, int *max val) 
PLOTEMP4.C. = ie ‘a = 


float avg temp(int num vals, int vals[]) 
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Finally, change table_view so that the return values from the 
functions are used properly. The revised table_view should read 
as follows: 


This change is included in void table view (void) 
PLOTEMP4.C 7 


int reading, min, max; 


clrscr (}; /* clear the screen */ 
printf ("Reading\t \tTemperature (F) \n"); 


for (reading = 0; reading < READINGS; readingt+t+) 
printf ("Sd\t\t\t$d\n", reading + 1, temps[reading]); 


min max(READINGS, temps, &min, &max); 

printf ("Minimum temperature: $d\n", min); 

printf ("Maximum temperature: %d\n", max); 

printf ("Average temperature: ¢f\n", avg _temp(READINGS, temps)); 
} 


Now for some debugging on your own. Check normal operations: 


m Are the loops working properly? 
m Are the arithmetic operations appropriate? 
a What do the comparisons compare? 


AAA 


Implementing 


g raph_view _ Recall that the graph_view function creates the chart shown in 
Figure 7.2. To implement this function, replace its definition with 
the following (and be sure to add #include <graphics.h> at the 
beginning of your code): 

Load PLOTEMPS.C. void graph view(void) 

int graphdriver = DETECT, graphmode; 


int reading, value; 
int maxx, maxy, left, top, right, bottom, width; 


int base; /* zero x-axis for graph */ | 

int vscale = 1.5; /* value to scale vertical bar size */ 

int space = 10; /* spacing between bars */ 

char fprint [20]; /* formatted text for sprintf */ 

initgraph(&graphdriver, &graphmode, ""); 

if (graphresult(} < 0) /* make sure initialized OK */ 
return; 

maxx = getmaxx(); /* farthest right you can go */ 

width = maxx / (READINGS + 1); /* scale and allow for spacing */ 

maxy = getmaxy() - 100; /* leave room for text */ 
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left = 25; 
right = width; 
base = maxy / 2; /* allow for neg values below */ 


for (reading = 0; reading <= READINGS; reading++) 
value = (temps[READINGS]) * vscale; 
if (value > 0) 
{ 
top = base - value; /* toward top of screen */ 
bottom = base; 
setfillstyle(HATCH FILL, 1); 
} 
else 
{ 
top = base; 
bottom = base - value; /* toward bottom of screen */ 
setfillstyle(WIDE DOT FILL, 2); 
} 
bar({left, top, right, bottom); 
left += (width + space); /* space over for next bar */ 
right += (width + space); /* right edge of next bar */ 
} 


outtextxy(0, base, "0 -"); 
outtextxy(10, maxy + 20, “Plot of Temperature Readings"); 
for (reading = 0; reading < READINGS; readingtt+) 
{ 
sprintf(fprint, “td", temps[reading]) ; 
outtextxy((reading *(width + space)) + 25, maxy + 40, fprint); 
} 


outtextxy(50, maxy+80, “Press any key to continue"); 
getch(); /* wait for a key press */ 


closegraph () ; 


save_temps and 


read_temps The function save_temps saves the current “scratchpad” (the 
contents of the array temps) to a disk file. By now, you should be 
familiar with the logic involved in accessing elements of this 
array. 


Replace the stub definition for the save_temps function with the 
following: 
Load PLOTEMPS.C. void save temps (void) 
{ 
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FILE * outfile; 
char file name[40]; 


printf("\nSave to what filename? "); 
while (kbhit()); /* “eat" any char already in keyboard buffer */ 
gets (file name); 
if ({outfile = fopen(file name,"wb")) == NULL) 
perror("\nOpen failed! "); 
return; 
fwrite(temps, sizeof({int), READINGS, outfile); 
felose (outfile); 


The function read_temps is the counterpart to save_temps; it 
reads values from a disk file into the temps array. Implement 
read_temps by replacing its stub definition with the following: 


This change 5s also included void read temps (void) 
in PLOTEMP5.C. ~ 


FILE * infile; 
char file name[40] = "test"; 


printf("\nRead from which file? "); 
gets(file name); 


while (kbhit());  /* “eat" any char already in keyboard buffer */ 
if((infile == fopen(file name,"rb")} == NULL) 
perror("\nOpen failed! "); 


fread(temps, sizeof(int), READINGS, infile); 
fclose ({infile); 


After you're finished with read_temps, you should have a 
complete, working version of PLOTEMP.C. (PLOTEMP6.C is a 
bug-free version of this program.) 


Answers to debugging exercises 


Here are the bugs in the remaining functions of PLOTEMP5.C. 


min _max and 


avg_temps In min_max, the If statements assign the value &vals[reading] 
(which is an address) to the min or max, rather than the correct 
value vals[reading]. Also, in avg_temp, the variable total should be 
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0. Having it start as 1 adds 1 to the total of the readings, thereby 
giving an incorrect average. 


By the way, note that this function receives and passes pointers to 
the calling function table_view—not the actual values of the 
variables. For more on this, review the material on pointers in 
Chapter 4. 


graph_view 
There are two sneaky bugs in this function. They are in the for 
loop: 


for (reading = 0; reading <= READINGS; readingt++) 
{ 
value = temps[{READINGS] * vscale; 


The value being read is temps[READINGS]—the constant 
READINGS instead of the variable reading. The result is that the 
only value that will be graphed is the nonexistent element 
temps[8]. In the second bug, the condition <= READINGS should be 

< READINGS to read the correct number of values. Notice how the 
first bug masks the second—often you can’t detect a given bug 
until you've fixed another bug, since the first bug prevents proper 
execution of the code containing the second bug. 


save_Ttemps 
Here, the problem is not in the first line of the for loop, but rather 
in the body: 
if ((outfile = fopen(file name, "wb")) == NULL) 
perror("\nOpen failed! "); 
return; 


Braces are needed to place both the perror statement and the 
return statement under the jurisdiction of the if. Thus the function 
always returns at this point, even if the file was opened correctly. 


The compiler warning “Unreachable code in function 
save_temps” means that the line following the return statement 
can never be executed. Without the braces, the return is always 
executed. 
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read_temps 


When you compiled this, you should have seen the compiler 
warnings “Possible use of infile before definition”. Consider the 
following code: 


if ((infile == fopen(file name,"rb")) == NULL) 


When you open a file, the file handle infile should be getting a 
value from fopen; the value is tested to see if it is NULL, 
indicating that the file opening failed. Why isn’t infile being 
defined (getting a value) as it is first used? The reason is that ==, 
rather than =, follows infile. Since == indicates a comparison rather 
than an assignment, infile isn’t getting a value. 
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// (comments) 124, 196 
\\ (display backslash) 52 
\" (display double quote) 52 
\? (display question mark) 52 
\’ (display single quote) 52 
== (equal to operator) 65 
>= (greater than or equal to operator) 65 
++ (increment operator) 56 
<= (less than or equal to operator) 65 
&& (logical AND operator) 67 
| | Gogical OR operator) 67 
!= (not equal to operator) 65 
:: (scope resolution operator) 132, 134, 154, 201 
= (assignment operator) 56 
\ (escape sequence character) 57 
“ (exclusive OR operator) 58 
; (for empty loops) 77, 198 
> (greater than operator) 65 
< (less than operator) 65 
% (modulus) 54 
! (NOT operator) 67 
<< operator 
overloading See see overloaded operators 
shift bits left 58 
>> operator 
overloading See see overloaded operators 
shift bits right 58 
| (OR operator) 58 
—— (decrement operator) 56 
& operator 
address 46 
AND 58 
+ operator 
overloading See overloaded operators, 
addition (+) 
~ operator 
1’s complement 58 
destructors 770 
1’s complement See operators, 1’s complement 
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# symbol (directives) 35 


A 
\a (audible bell) 52 
access 
class members 200 
classes 124 
structures vs. 137 
data members 136, 183 
data members and member functions 124 
functions and variables 109, 134 
information hiding and 136 
inheritance and 143 
member functions 136 
modes 178, 120 
structures 
classes vs. 137 
address, Borland 7 | 
address operator (&) 46 
addresses, memory See memory, addresses 
alert character (\a) 52 
American National Standards Institute See 
ANSI 
ancestors See classes, base 
AND operator (&) 58 
ANSI 
C standard 3 
arguments 
constructors 135 
default 135, 176 
C++ 199 
constructors and 179 
mode 197 
passing in C++ 767 
arithmetic 
operations 53 
combining with assignment operator 56 
pointers 712 
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arrays 
declaring and initializing 97, 99 
elements 98 
evaluating 230 
number of values 237 
indexes 175 
inspecting 228 
multidimensional 99 
new operator and 7169 
passing to functions 276 
range errors 99 
strings and 7107 
ASCII codes 
characters 62 
assignments 
combination 44 
defined 43 
multiple 44 
operator (=) 
combining with other operators 56 
associativity 
rules 60 
table 67 
audible bell (\a) 52 
auto variables See variables, automatic 


\b (backspace character) 52 
backslash character 
printing 52 
backspace character (\b) 52 
bad (member function) 197 
bar 
execution See run bar 
run See run bar 
BARCHART.C 
loading 22 
modifying 24 
base classes See classes, base 
beep 52 
bell (\a) 52 
.BGI files 
calling 84 
bibliography 249-252 
binary files 
opening 178 
binary numbers 37 
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binding See C++, binding 
bits 
manipulating 58 
blocks, text See editing, block operations 
Boolean data type 130 
Borland 
address 7 
CompuServe Forum 7 
technical support 7 
Borland Graphics Interface (BGI) 
using 84 
boundary conditions 242 


branching See if statements; switch statements 


break statements 
exiting loops and 77 
buffers 
file 197 
bugs 273, See also debugging 
reporting to Borland 8 


Cc 
C++ 121-194, 195-2117 
argument 
passing 167 
arguments 7176, 199 
binding 
early vs. late 157 
late 128, 156, 210, See also member 
functions, virtual 
early vs. 157 
example 160 
classes See classes 
comments 124, 196 
compiling 138 
constants 198 
constructors 207, See constructors 
data members See data members 
declarations 197 
#define and 198 
destructors See destructors 
defined 202 
dynamic objects See also objects 
encapsulation 123 
defined 127 
examples 
dictionary 200 
file buffers 197 
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formatting See formatting 
friend functions 
declaring 204 
functions See also member functions 
default arguments for 776 
friend 183, 184 
inherited 154 
inline 139, 175, 198 
classes and 200 
header files and 140 
one line 198 
overloading See overloaded functions 
virtual 270 
virtual keyword and 759 
graphics classes 129 
header files 144, 196 
hierarchies See classes 
I/O 185 
flushing cout 797 
formatting 189 
performing 196 
inheritance See inheritance 
initialization 202 
inline functions See C++, functions, inline 
1/O 
disk 189 
formatting 187 
put and write functions and 188 
member functions See member functions 
members 
initialization list 155 
objects 
declaring 137 
operators See operators, C++; overloaded 
operators 
polymorphism 128, See polymorphism 
primer 121-194 
programs 
compiling 138 
Smalltalk vs. 123 
streams See streams, C++ 
cin, cout, and cerr 785 
cout 
flushing 197 
defined 140 
strings 
concatenating 780 
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structures See structures 
Turbo C++ implementation 3 
tutorial 795-2717 
types 
reference See reference types 
variables 
declaring anywhere 198 
C language 37-120, See also C++ 
history 37 
overview 31-120 
Call Stack window 238 
calling sequence, functions 238 
carriage return character (\r) 52 
case sensitivity 45 
case statements See switch statements 
cerr (C++ stream) 185 
characters 
ASCII 62 
carriage return (\r) 52 
char data type See data types, char 
displaying 46, 63 
escape sequence 57 
format specifiers 46 
formfeed (\f) 52 
getch function and 63 — 
getche function and 63 
header file 96 
newline (\n) 52 
nonprinting 
Inspector window and 228 
null 
defined 64 
strings and 7107 
printable 52 
putch and 63 
reading 
and formatting 46 
from keyboard 62 
separator 48 
set of 62 
special, displaying 52 
storage 62 
strings and 65 
tab (\t) 52 
unsigned char data type 
range 39 
charts See graphics, charts 
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check boxes 79 
cin (C++ stream) 140, 185 
using 197 
class (keyword) 200 
classes See also structures 
access 204 
structures vs. 137 
base 1417, 205 
defined 127 
class keyword 200 
constructors 133 
arguments 135 
defining 135 
inline 135 
naming 7135 
defined 124 
derived 147, 205 
creating 143, 207 
defined 127 
deriving 748 
destructors 134 
friend functions and 184, 204 
graphics 129 
hierarchies 
common attributes in 162 
initializing automatically 133 
inline keyword and 200 
instantiation and 124 
istream, ostream, and iostream 785 
libraries 145 
members 
access 200 
private 
accessing 204 
overloaded operators and 186 
projects and 7145 
relative position 193 
streambuf 785 
structures vs. 124 
TLIB and 145 
clear (function) 
C++ stream errors and 797 
clog (C++ stream) 185 
colors See graphics, colors 
combination assignments 44 
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command-line compiler 
directives See directives 
options 
compile C++ (-P) 138 
—-P (compile C++) 138 
using 28 
commands See individual command names 
comments 35 
// 124 
C++ (//) 196 
compatibility 
mice 3 
Compile 
command 28 
menu 
Full Menus On and Off 79 
using 28 
compiler directives See directives 
#define 
constants and 94 
CompuServe Forum, Borland 7 
conditions, boundary 242 
console 
I/O 
example program 276 
const (keyword) 94 
constants 94 
C++ 198 
manifest or symbolic See macros 
constructors 733, See C++, constructors 
accepting default arguments 179 
arguments 735 
calling with no arguments 779 
classes 
base 146 
derived 146 
default 147 
defining 735 
inline 135, 140 
naming 135 
new operator and 134 
order of calling 
example 155 
continue statements 77 
conventions 
typographic 6 
conversion specifications See format specifiers 
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conversions 
printf and 57 
rules 55 
table 55 


copy and paste See editing, copy and paste 
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loose 240 

cout (C++ stream) 7140, 185 
flushing 197 

.CPP files See C++ 


D 


data 
declaring 33 
inspecting 227 
structures See also arrays; structures 
naming 103 
pointers and 109 
data hiding See access 
data members 
access 124, 125, 136 
accessing 7136 
private 183 
defined 124 
member functions and 134 
scope 143 
data types See also data 
Boolean 130 
char 
range 39 
strings and 65 
choosing appropriate 40 
converting See conversions 
enumerations 
range 39 
using 704 
floating point See floating point 
integers See integers 
new 105 
numeric 37 
promotion 55 
ranges 39 
renaming 703 
table of 39 
typedef and 703 
unsigned char 
range 39 
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Debug menu 274 
debugging 


breakpoints See breakpoints 
Call Stack window 238 
data 

changing values 232 

inspecting 227 
defined 2173 
designing programs for minimum 239 
Evaluate field and 229 
exercises 243 

answers 246 
expressions 

changing values 232 
functions 223 
inspectors and 227 
locating a function 237 
multiple files 239 
multiple variables 232 
PLOTEMP.C 216 
step Over command 222 
syntax errors 227 
Trace Into command 223 
tutorials 213-248 
User screen and 222 
values 

changing 232 
windows 236 


dec (manipulator) 788 
declarations 


data See data, declaring 
global 86 
improving legibility 706 
location 
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declarators 107 


designing 106 
with typedefs 108 
without typedefs 107 


decrement operator (——) 56 
default arguments See arguments, default 
#define (directive) 35 


constants and 94 


delete (operator) 


destructors and 134, 170 
syntax 770 
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derived classes See classes, derived 
descendants See classes, derived 
designing programs 80 
destructors 
auto objects and 170 
deallocating memory and 770 
delete operator and 134, 170 
dynamic objects and 170 
implicit 170 
static objects and 7170 
dialog boxes See also buttons; check boxes; list 
boxes; radio buttons 
find and replace 25 
dictionary example 200 
directives 
#define 35 
C++ and 7198 
constants and 94 
defined 35 
#include 35 
disks 
distribution 
defined 70 
displays See screens 
distribution disks 3 
backing up 9 
distributions disks, defined 70 
division See floating point, division; integers, 
division 
do while loops See loops, do while 
double (floating point) See floating point, 
double 
double quote character 
displaying 52 
strings and 65 
duration 97 
dynamic binding See C++, binding, late 
dynamic objects See objects, dynamic 


early binding See C++, binding 
Edit See also editing 
menu 24 
windows 
closing 29 
multiple 23 
new 23 
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scroll bars 23 
editing See also Edit 
block operations 
copying 26 
deleting 27 
selecting 24 
copy and paste 24 
cursor movements 23 
find and replace 
dialog boxes 25 
loading files 27 | 
mouse 23 | 
pasting See editing, copy and paste 
search and replace 25 
selecting text 24 
text blocks 
selecting 24 
tutorials 27 
elements of arrays 98 
else clauses See if statements 
empty loops 77, 198 
encapsulation 727, See also C++ 
end! (manipulator) 788 
ends (manipulator) 188 
enumerations 704 
range 39 
environment See integrated environment 
eof (member function) 797 
equal to operator (==) 65 
errors 
array size 99 
C++ streams 
clearing 197 
messages 
which book to look in for 5 
escape sequences 57 
Evaluate command 
inspectors vs. 229 
Evaluate field 
arrays 230, 231 
copying into 232 
debugging and 229 
display format 230 
expressions in 
rules governing 230 
format specifiers and 230 
memory dump and 237 
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pointers and 237 

variables 230 
examples 

relational operators 66 
exclusive OR operator (“) 58 
-EXE files 

generating 28 
execution 

bar See run bar 

line-by-line 223 

stepping over functions 222 
expressions 

assigning values in 67 

conditional 67 

debugging 

changing values of 232 

defined 44, 59 

displaying value of 230 

evaluating 59 

watch See Watch, expressions 
extensibility See also C++ 
extern (keyword) 

using 93 
extraction operator (>>) See overloaded 

operators 
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\f (formfeed character) 52 
fail (member function) 197 
features of Turbo C++ 7, 13 
field width, C++ 188 
files See also individual file-name extensions 
access modes 178, 120 
binary 118 
buffers, C++ 197 
C++ See C++ 
CCP See C++ 
copying 23 
disk 
copying using C++ 189 
reading 178 
writing 178 
editing See editing 
header See header files 
HELPME!.DOC 10, 12 
1/O 
example program 216 
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include See include files 
library (.LIB) See libraries 
modifying 25 
new 23 
opening 22 
pointers to 178 
reading 120 
README 1717 
README.DOC 10 
saving 24, 27 
using 178 
example program 119 
writing to 120 
Find command See Search menu 
flags 
format state See formatting, C++, format 
state flags 
floating point See also integers; numbers 
defined 40 
displaying 46, 50 
division 47 
double 
defined 42 
long See floating point, long double 
range 39 
format specifiers 46 
long double 
defined 42 
range 39 
ranges 39 
reading and formatting 46 
flush (manipulator) 188 
fopen (function) 
files and 120 
streams and 178 
for loops See loops, for 
format specifiers 46, See also formatting 
characters and strings and 65 
Evaluate field and 230 
memory dump 237 
pointers and 2317 
precision 57 


format state flags See formatting, C++, format 


state flags 
formatting See also format specifiers 
C++ 
field width 788 


format state flags 187 
put and write functions and 188 
C++ I/O 187, 189 
escape sequences and 57 
formfeed character (\f) 52 
fprintf (function) 
stream pointers and 120 
friend (keyword) 
classes and 184 
friend functions See C++, friend functions 
Full Menus command 
described 719 
function signature 758 
functions See also individual function names; 
member functions; scope 
accessing variables and 709 
calling 34, 238 
debugging 222, 223 
declarations 
global 86 
declaring under Kernighan and Ritchie 87 
defined 33 
defining 82 
finding 237 
friend See C++, functions, friend 
header 82 
inline 
C++ 175 
syntax 176 
inline, C++ 798 
classes and 200 
inspecting 229 
library 
defined 34 
macros and 96 
member See member functions 
multiple 84 
one line 798 
ordinary member See member functions, 
ordinary 
overloaded See overloaded functions 
parameters See parameters 
passing arrays to C++ 276 
pointers and 109, 115 
prototypes 87 
return values 83 
signature 158 
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stepping over 222 

tracing through 223 

usefulness of 36 

user-defined 80 

virtual See member functions, virtual 
syntax 159 

writing your own 80 
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get (function) 189 | 
get from (>>) See overloaded operators 
getch (function) 
characters and 63 
getche (function) 
characters and 63 
getmaxx (function) 
example 87 
getmaxy (function) 
example 87 
global declarations See declarations, global 
global variables 
scope and 93 
goto statement 78 
graphics See also graphics drivers 
charts 216 
classes 129 
colors 
header file 87 
symbolic names 87 
coordinates 87 
fill patterns 
header file 87 
header file 87 
graphics drivers See also graphics 
testing for presence 87 
graphics.h (header file) 87 
greater than operator (>) 65 
greater than or equal to operator (>=) 65 
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hardware 
requirements 
mouse 2 
requirements to run Turbo C++ 2 
header files See also include files 
C++ 144 


Turbo C++ Getting Started 


characters 96 
ctype.h 96 
defined 35, 89 
graphics.h 87 
inline C++ functions and 140 
stdio.h 178 
stream.h vs. stdio.h 196 
using 90 
help 27 
Help window 
copying from 26 
HELPME!.DOC file 10, 12 
hex (manipulator) 788 
hexadecimal numbers See numbers, 
hexadecimal 
hierarchies See classes 
history of C 37 
horizontal tab character (\t) 52 
hot keys 
defined 20 


IDE See integrated environment 
identifiers 45 
data structures 103 
variables 45 
if statements 67 
else 68 
nesting 69 
IMSI mouse compatibility 3 
include files See also header files 
defined 35 
#include directive 
defined 35 
increment operator (++) 56 
indexes See arrays 
indirection 176 
information hiding See access 
inheritance 126, 141 
access and 143 
base and derived classes and 147 
defined 122 
example 205 
functions and 154 
multiple 728, 1517 
defined 142 
rules 743 
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initgraph (function) path argument and 84 
initialization See specific type of initialization 
constructors and destructors and 133 
initializing 
arrays 97, 99 
variables 43 
inline (keyword) 198 
classes and 200 
constructors and 735 
member functions and 132 
inline functions, C++ See C++, functions, inline 
input boxes 79 
insertion operator (<<) See overloaded 
operators 
inspectors 
abilities of 227 
arrays 228 
data 227 
Evaluate command vs. 229 
functions 229 
strings 228 
structures 228 
unions 228 
installation 70-77 
ona laptop system 77 
instances See classes, instantiation and 
instantiation See classes, instantiation and 
integers See also floating point; numbers 
displaying 46, 50 
division 47 
format specifiers 46 
long 
range 39 
using 40 
range 39 
reading and formatting 46 
unsigned 
range 39 
using 39 
integrated debugger See debugging 
integrated development environment See 
integrated environment 
integrated environment 
debugging See debugging 
editing See editing 
exiting 29 
getting the best out of 14 
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menus See menus 

quitting 29 

tutorial 17-29 
I/O 

disk 7189 
I/O, C++ See C++, 1/O 
iomanip.h (header file) 788 
isalpha (function) 96 
istream 185 
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Kernighan and Ritchie (K&R) 
function declarations 87 
significance of 37 

keyboard 
reading characters from 62 
stream 120 

keys, hot See hot keys 

keywords 
auto 93 
class 200 
const 94 
extern 93 
inline 798 

classes and 200 
new 

malloc and 207 
operator 780 
register 94 
static 93 
typedef 703, 107, 108 
void 87 
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laptop computers 

installing Turbo C++ onto 77 
late binding See C++, binding 
LCD displays 

installing Turbo C++ for 77 
less than operator (<) 65 
less than or equal to operator (<=) 65 
libraries . 

class 145 

streams 184 

using 90 
license statement 9 
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list boxes 
defined 79 
using 22 
Locate Function command 237 
logical AND operator (&&) 67 
logical OR operator (| |) 67 
Logitech Mouse compatibility 3 
long double (floating point) See floating point, 
long double 
long integers See integers, long 
loops 
choosing 80 
defined 72 
do while 73 
exiting 77 
empty 77, 198 
exiting 77 
for 75 
while loop and 77 
nested 79 
while 72 
exiting 77 
for loop and 77 
loose coupling 240 
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macros 35, 80 
functions and 96 
isalpha 96 
random 107 
using 95 

main (function) 33 
prototype 87 

Make EXE command 28 

malloc (function) 
new and 207 

manifest constants See macros 

manipulators 188, See also formatting, C++; 
individual manipulator names 
header file for 788 
parameterized 7188 
user-defined 793 

manuals 
using 74 

maximize See zooming 

member functions 137, See also C++, functions; 
data members 
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access 124 136, 200 
access to variables 134 
adding 137 
calling 132 
choosing type 168 
data 
access 125 
defined 124 
defined outside the class 132 
example 134 
inline 737, 132 
open and close 789 
ordinary 
problems with inherited 157 
virtual vs. 157, 163, 168 
overriding 755 
positioning in hierarchy 162 
signature 158 
stream state 197 


virtual 156, 157, 159, See also C++, binding, 


late 
ordinary vs. 163, 168 
pros and cons 162 
members 
data See data members 
functions See member functions 
memory 
addresses 
sscanf and 46 
deallocating 
destructors and 170 
dump 
Evaluate field and 2317 
freeing 
automatically 93 
strings and 64 
menus See also individual menu names 
closing 78 
exiting 78 
opening 78 
messages See errors; warnings 
methods See member functions 
mice See mouse 
Microsoft Mouse compatibility 2 
mode arguments 797 
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modes 

access 

using 7178, 120 

modularity See encapsulation 
modulus operator (%) 54 
mouse 

compatibility 2 

using 20 
Mouse Systems mouse compatibility 3 
moving text See editing, moving text 
multidimensional arrays 99 
multiple assignments 44 
multiple inheritance See inheritance 
multiwindowing 23 
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\n (newline character) 52 
names See identifiers 
nesting, 
if statements 69 
loops 79 
new (keyword) 
recommended return value 207 
new (operator) 
arrays and 169 
constructors and 734 
dynamic objects and 169 
malloc function and 207 
syntax 169 
new lines 
creating in output 52 
newline character (\n) 52 
not equal to operator (!=) 65 
NOT operator (!) 67 
null character See characters, null 
numbers See also floating point; integers 
binary 37 
hexadecimal 
displaying 52 
octal 
displaying 52 
random 
generating 107 
real See floating point 
typecasting 55 


263 
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object-oriented programming See C++ 
objects See also C++ 
auto 
destructors and 170 
dynamic 168 
allocating and deallocating 170 
destructors and 770 
new operator and 169 
static 
destructors and 770 
oct (manipulator) 788 
octal numbers See numbers, octal 
one-line functions 
C++ 198 
one’s complement See operators, 1's 
complement 
online help See help 
OOP See C++ 
open (function) 197 
C++ formatting and 189 
operator (keyword) 780 
operators 
1s complement 58 
address (&) 46 
AND (&) 58 
arithmetic 53 
assignment (=) 56 
associativity See associativity 
bit manipulation 
using 58 
C++ See also overloaded operators 
delete See delete (operator) 


get from (>>) See overloaded operators 


new 201, See new (operator) 
new (operator) 169 
put to (<<) See overloaded operators 
scope resolution (::) 132, 134, 154 
combining 56 
decrement (— —) 56 
equal to (==) 65 
exclusive OR operator (“) 58 
greater than (>) 65 
greater than or equal to (>=) 65 
increment (++) 56 
less than (<) 65 
less than or equal to (<=) 65 
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logical AND (&&) 67 
logical OR (1 |) 67 
modulus (%) 54 
NOT (!) 67 
not equal to (!=) 65 
one’s complement See operators, 1’s 
complement 
OR (1) 58 
overloading See overloaded operators 
precedence 
defined 53 
rules 60 
table 67 
relational 65 
remainder (%) 54 
scope resolution (::) 207 
shift bits (<< and >>) 58 
sizeof 175 
unary 58 
options See integrated environment 
OR operator (|) 58 
ordinary member functions See member 
functions, ordinary 
overlays 
getting the best out of 74 
overloaded functions 128, 177 
overloaded operators 180 
>> (get from) 140, 192 
<< (put to) 140, 192, 196 
addition (+) 780 
class for 186 
defined 196 
restrictions 182 
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-P TCC option (compile C++) 138 
parameterized manipulators 188 
parameters 

functions and 82 

reference 199 
pasting See editing, copy and paste 
paths 

.BGI files 84 
PC Mouse compatibility 3 
PLANETS.C (sample program) 84 
plasma displays 

installing Turbo C++ for 77 
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PLOTEMP.C (sample program) 216 
pointers 709 

arithmetic 772 

declaring 709 

to files 178 

format specifiers and 237 

functions and 115 

range 39 

to self See this (keyword) 

to streams 

fprintf and 120 

strings and 177 

structures and 172 
polymorphism 

defined 122 

example 270 

virtual functions and 128 2170 
pop-up menus See also menus 
precedence 

defined 53 

rules 60 

table 67 
preprocessor directives See directives 
primer 

C++ 121 
printable characters 52 
printbase characters 52 
printers 

streams 120 
printf (function) 

conversion specifications 49 

format specifiers 46, 49 

introduced 33 

using 49 
private (keyword) 136 

classes and 137 
procedures See functions 
programmer's platform See integrated 

environment 
programming 

with classes See C++ 
programs 

basic operations 32 

C++ See C++ 

designing 80, 239 

multifunction 84 
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multiple 
debugging 239 
prototypes and 216, 218 
robust (definition) 247 
solar system 84 
swap 116 
testing 240 
projects 
classes and 145 
protected (keyword) 137, 209 
prototypes 87 
main function 87 
public (keyword) 137, 207 
pull-down menus See menus 
put (function) 188 
put to (<<) See overloaded operators 
put to operator (<<) See overloaded operators 
putch (function) 
characters and 63 
puts (function) 
strings and 64 
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question mark 
displaying 52 
Quit command 29 
quotes 
displaying 52 
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\r (carriage return character) 52 
radio buttons 
defined 19 
random (macro) 107 
random numbers See numbers, random 
range errors, arrays 99 
rdstate (member function) 197 
README 17 
README.DOC 10 
real numbers See floating point 
reference parameters 199 
reference types 167 
referencing and dereferencing 199 
register (keyword) 
using 94 
relational operators See operators, relational 
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relative position 
C++ and 193 
remainder operator (%) 54 
resetiosflags (manipulator) 788 
return 
statements 
maximum number 87 
values 
functions 83 
Ritchie, Dennis See Kernighan and Ritchie 
robust programs (definition) 247 
run bar 222 
Run command 28 


S 
SALESTAG.C (sample program) 34 
sample programs 
PLANETS.C 84 
PLOTEMP.C 276 
SALESTAG.C 34 
scope 97, See also variables 
C++ 
data members 143 
functions 732 
extern keyword and 93 
function variables 82 
global declarations and 86 
global variables and 93 
resolution operator (::) 132, 134, 154, 2017 
side effects and 93 
screens 
LCD 
installing Turbo C++ for 17 
plasma 
installing Turbo C++ for 77 
streams 7120 
scroll bars 23 
Search menu 25 
self See this (keyword) 
semicolon (for empty loops) 77 
separator characters 48 
setbase (manipulator) 188 
setfill (manipulator) 188 
setiosflags (manipulator) 788 
setprecision (manipulator) 788 
setw (manipulator) 188 
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shift bits operators (<< and >>) 58 
shortcuts See hot keys 
side effects 93 
sign 
defined 40 
signature, function 758 
single quote character 
characters and 65 
displaying 52 
sizeof (operator) 175 
Smalltalk 
C++ vs. 123 
software See programs 
software license agreement 9 
software requirements to run Turbo C++ 2 
solar system 
program 84 
sounds 
beep 52 
sscanf (function) 
address operator and 46 
format specifiers 46 
introduced 33 
separator characters 48 
using 46 
statements See also break statements; if 
statements; switch statements 
defined 33 
static (keyword) 93 
static binding See C++, binding, early 
status line 27 
staux, functions of 120, See also streams 
stdin, functions of 120, See also streams 
stdio.h (header file) 35, 178 
stream.h vs. 196 
stdout, functions of 120, See also streams 
Step Over command 
debugging and 222 
sterr, functions of 720, See also streams 
stprn, functions of 720, See also streams 
strcat (function) 102, 103 
strcmp (function) 
example 79 
strcpy (function) 703 
stream.h 
stdio.h vs. 196 
streambuf 185 
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binary 
opening 778 
C++ 184-192 
file buffers 197 
library 184 


manipulators and See manipulators 


open function and 197 
default 120 
defined 178 
functions of 720 
keyboards 120 
opening 118, 120 
pointers 

fprintf and 120 
preopened 120 
printers 7120 
screens 720 
standard 

table 120 
text 

opening 7178 
using 178 

example program 119 
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arrays and 707 
characters and 65 
combining 103 
concatenating 103, 180 
creating 103 
defined 64 
displaying 46, 64 
format specifiers 46 
inspecting 228 
literal 64 
memory and 64 
null character and 107 
pointers and 777 
puts and 64 
reading and formatting 46 
streat and 102 
strtok and 102 
variables 

defining 102 


~ strlen (function) 


example 79 
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strtok (function) 102 
structures 

access 

classes vs. 137 

C++ See also classes 

classes vs. 124 

defined 105 

inspecting 228 

members 

defined 105 

pointers and 172 
swap (example) 115 
switch statements 70-72 

break See break statements 
symbolic 

constants See macros 
syntax 

delete operator 170 

inline functions 776 

new operator 169 
system 

requirements 2 

resources 177 
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\t (horizontal tab character) 52 
tab (manipulator) 193 
tab characters 52 
taxonomy 
defined 127 
TC and TCC See command-line compiler; 
integrated environment; Turbo C++ 
technical support 7 
temperature-plotting program 216 
testing software 240 
text 
blocks See editing, block operations 
screen mode See screens 
text files See also editing 
opening 118 
this (keyword) 182 
TLIB (librarian) 
classes and 145 
Trace Into command 
debugging and 223 
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Turbo C++ See also C++; integrated 
environment 
bugs 
reporting 8 
exiting 10, 29 
implementation data 3 
installing 10-77 
on laptops 77 
quitting 29 
starting 70 
tutorials 
BARCHART.C 22 
C++ 195-217 
compiling and running 28 
debugging 213-248 
editing 27 
files, modifying 25 
graphics chart display 22 
loading files 27 
searching and replacing 25 
summary 7/4 
typecasting 
defined 55 
typedef (keyword) 703 
declarators and 107, 108 
typefaces used in these books 6 
types See data types 
typographic conventions 6 
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unary operators See operators, unary 
unconditional breakpoints See breakpoints 
unions 

inspecting 228 
User Screen 

using 28 
User screen 

command 222 

debugging and 222 
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\v (vertical tab character) 52 

variables Seealsoscope _ 
address operator and 46 
assignment statements 43 
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automatic 93 
declaring 43 
declaring anywhere (C++) 198 
default values 43 
evaluating 230 
initializing 43 
instances and objects and 130 
local 97 
naming 45, 240 
pointers and 103, 109 
sharing 86 
signed and unsigned 40 
static 93 
string 102 
watching 235 
vertical tab character (\v) 52 
virtual (keyword) 159 
virtual access See also C++ 


virtual functions See member functions, virtual 


visibility See scope 
void (keyword) 
defined 87 
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warning beep 52 
warnings 
messages 
which book to look in for 5 
Watch 
expressions 235 
Watch menu 235 
watches 
deleting 237 
editing 237 
setting 235 
while loop See loops, while 
window number 22 
windows 
Call Stack 238 
debugging 236 
Edit See Edit, window | 
Inspector 227 
multiple 23 
write (function) 788 
ws (manipulator) 788 
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